@roomwise/calc-engine 0.4.0 → 0.6.0

package/dist/index.js

@@ -26,6 +26,73 @@ function toCents(dollars) {
 	return cents;
 }
 //#endregion
+//#region src/variables/putty.ts
+function puttyRequiredOn(room, surface, categories) {
+	const selected = categories.filter((category) => category.surface === surface && room.selections.some((selection) => selection.categoryId === category.id));
+	return selected.length === 0 || selected.some((category) => category.requiresPutty);
+}
+//#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, categories) {
+	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),
+		roomsPuttyWallArea: configuration.rooms.reduce((total, room) => puttyRequiredOn(room, "WALLS", categories) ? total + roomVariables(room).wallArea : total, 0),
+		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) {
@@ -55,18 +122,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) {
@@ -82,16 +156,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));
@@ -100,7 +197,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: {
@@ -108,12 +205,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
@@ -122,29 +219,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 = {
@@ -169,51 +243,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
@@ -647,13 +677,91 @@ 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 category = data.categories.find((item) => item.id === line.categoryId);
+		if (line.status === "OK" && category !== void 0 && category.surface !== "NONE") {
+			const surface = category.surface;
+			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],
+				puttyRequired: puttyRequiredOn(room, surface, data.categories)
+			},
+			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",
@@ -685,7 +793,7 @@ function materialLine(configuration, data, room, categoryId, productId) {
 	const variables = {
 		...roomVariables(room),
 		...productVariables(product, category),
-		...objectVariables(configuration)
+		...objectScope
 	};
 	const { coefficients } = data;
 	const ruled = {
@@ -706,32 +814,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
@@ -739,11 +889,17 @@ const LocalizedTextSchema = z.object({
 	en: z.string(),
 	uk: z.string()
 });
-const FinishLevelSchema = z.enum(["ROUGH", "PRE_FINISH"]);
+const ScopeSchema = z.enum(["FULL", "PARTIAL"]);
+const FinishLevelSchema = z.enum([
+	"ROUGH",
+	"PRE_FINISH",
+	"LIVED_IN"
+]);
 const RuleLevelSchema = z.enum([
 	"OBJECT",
 	"CATEGORY",
-	"MATERIAL_TYPE"
+	"MATERIAL_TYPE",
+	"SURFACE"
 ]);
 const RateSourceSchema = z.enum(["NBU", "MANUAL"]);
 const SurfaceKindSchema = z.enum([
@@ -770,7 +926,9 @@ const RoomTypeCodeSchema = z.enum([
 	"BEDROOM",
 	"KITCHEN",
 	"KITCHEN_LIVING",
-	"BATHROOM"
+	"BATHROOM",
+	"HALLWAY",
+	"STORAGE"
 ]);
 const CurrencySchema = z.enum(["USD", "UAH"]);
 const SectionSchema = z.enum([
@@ -780,6 +938,11 @@ const SectionSchema = z.enum([
 	"ENGINEERING",
 	"ADDITIONAL"
 ]);
+const LineComponentKindSchema = z.enum([
+	"MATERIAL",
+	"LABOR",
+	"PREP"
+]);
 const LineStatusSchema = z.enum([
 	"OK",
 	"INCLUDED",
@@ -823,8 +986,9 @@ function duplicateIndexes(items, key) {
 	});
 }
 const ConfigurationSchema = z.object({
+	scope: ScopeSchema.default("FULL"),
 	finishLevel: FinishLevelSchema,
-	totalAreaSqm: z.number().positive(),
+	totalAreaSqm: z.number().positive().nullable(),
 	balconyAreaSqm: z.number().min(0),
 	balconyTiles: z.boolean(),
 	rooms: z.array(RoomConfigurationSchema),
@@ -836,6 +1000,11 @@ const ConfigurationSchema = 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,
@@ -867,13 +1036,8 @@ const PricingLimitsSchema = z.object({
 	totalAreaSqm: RangeSchema,
 	rooms: RangeSchema,
 	roomSideM: RangeSchema,
-	roomHeightM: RangeSchema
-});
-const BaseRateSchema = z.object({
-	finishLevel: FinishLevelSchema,
-	areaFromSqm: z.number().min(0),
-	areaToSqm: z.number(),
-	rateCentsPerSqm: z.int().positive()
+	roomHeightM: RangeSchema,
+	missingAreaHintSqm: z.number().min(0)
 });
 const PricingRuleSchema = z.object({
 	id: z.string(),
@@ -882,9 +1046,16 @@ const PricingRuleSchema = z.object({
 	materialTypeId: z.string().nullable(),
 	name: LocalizedTextSchema,
 	quantityFormula: z.string().nullable(),
+	surface: z.enum([
+		"FLOOR",
+		"WALLS",
+		"CEILING"
+	]).nullable(),
+	baseComponent: z.boolean(),
 	costFormula: z.string().max(500),
+	laborFormula: z.string().max(500).nullable(),
 	sortOrder: 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 = z.object({
 	id: z.string(),
 	code: z.string()
@@ -892,7 +1063,8 @@ const PricingRoomTypeSchema = z.object({
 const PricingCategorySchema = z.object({
 	id: z.string(),
 	wastePercent: z.number().min(0),
-	surface: SurfaceKindSchema
+	surface: SurfaceKindSchema,
+	requiresPutty: z.boolean().default(true)
 });
 const PricingMaterialTypeSchema = z.object({
 	id: z.string(),
@@ -914,22 +1086,43 @@ const PricingPackageItemSchema = z.object({
 	priceCents: CentsSchema.nullable(),
 	unit: OptionUnitSchema.nullable()
 });
-const PricingOptionSchema = z.object({
+const PricingOptionObjectSchema = z.object({
 	id: z.string(),
 	code: OptionCodeSchema.nullable(),
 	kind: OptionKindSchema,
-	priceCents: CentsSchema,
+	priceCents: CentsSchema.nullable(),
 	unit: OptionUnitSchema,
 	roomTypeCodes: z.array(z.string()),
+	priceCoefficientKeys: z.array(z.string()),
+	scopes: z.array(ScopeSchema).min(1),
 	minQuantity: z.int().nullable(),
 	maxQuantity: z.int().nullable(),
 	available: z.boolean()
 });
+function findOptionPriceSourceViolation(priceCents, priceCoefficientKeys) {
+	const hasKeys = priceCoefficientKeys.length > 0;
+	if (priceCents !== null && hasKeys) return {
+		path: "priceCents",
+		message: "priceCents must be null when priceCoefficientKeys is set"
+	};
+	if (priceCents === null && !hasKeys) return {
+		path: "priceCoefficientKeys",
+		message: "priceCoefficientKeys is required when priceCents is null"
+	};
+	return null;
+}
+const PricingOptionSchema = PricingOptionObjectSchema.superRefine((option, context) => {
+	const violation = findOptionPriceSourceViolation(option.priceCents, option.priceCoefficientKeys);
+	if (violation !== null) context.addIssue({
+		code: "custom",
+		path: [violation.path],
+		message: violation.message
+	});
+});
 const PricingDataSchema = z.object({
 	version: z.string().regex(/^[0-9a-f]{16}$/),
 	exchangeRate: ExchangeRateSchema.nullable(),
 	limits: PricingLimitsSchema,
-	baseRates: z.array(BaseRateSchema),
 	coefficients: z.record(z.string(), z.number()),
 	rules: z.array(PricingRuleSchema),
 	roomTypes: z.array(PricingRoomTypeSchema),
@@ -945,6 +1138,12 @@ const EstimateMessageSchema = z.object({
 	code: z.string(),
 	params: z.record(z.string(), z.unknown()).optional()
 });
+const LineComponentSchema = z.object({
+	kind: LineComponentKindSchema,
+	ruleId: z.string(),
+	amountCents: z.number().int().min(0),
+	sharedWithCategoryId: z.string().optional()
+});
 const EstimateLineSchema = z.object({
 	id: z.string(),
 	section: SectionSchema,
@@ -960,6 +1159,7 @@ const EstimateLineSchema = z.object({
 	unitPriceCents: CentsSchema.nullable(),
 	amountCents: CentsSchema,
 	amountUahKopecks: CentsSchema.nullable(),
+	components: z.array(LineComponentSchema).optional(),
 	warnings: z.array(EstimateMessageSchema),
 	error: EstimateMessageSchema.nullable()
 });
@@ -997,18 +1197,34 @@ const RuleSampleSchema = z.object({
 		unit: ProductUnitSchema,
 		wastePercent: z.number().min(0)
 	}).optional(),
+	surfaceArea: z.number().min(0).optional(),
+	puttyRequired: z.boolean().optional(),
 	object: z.object({
-		totalAreaSqm: z.number().positive(),
+		scope: ScopeSchema,
+		totalAreaSqm: z.number().positive().nullable(),
 		balconyAreaSqm: z.number().min(0),
 		balconyTiles: z.boolean(),
 		finishLevel: FinishLevelSchema,
 		roomsCount: z.int().min(0),
-		bathroomsCount: z.int().min(0)
+		bathroomsCount: z.int().min(0),
+		roomsFloorArea: z.number().min(0),
+		roomsWallArea: z.number().min(0),
+		roomsPuttyWallArea: z.number().min(0).optional(),
+		roomsPerimeter: z.number().min(0),
+		wetRoomsCount: 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 = z.object({
 	quantity: z.number().nullable(),
 	amountCents: CentsSchema.nullable(),
+	laborCents: CentsSchema.nullable(),
 	variables: z.record(z.string(), z.union([
 		z.number(),
 		z.boolean(),
@@ -1043,20 +1259,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" }] : []
 	];
 }
@@ -1070,10 +1294,11 @@ function withKopecks(line, rate) {
 }
 function estimate(configuration, data) {
 	const rate = data.exchangeRate?.rate ?? null;
+	const variables = objectVariables(configuration, data.categories);
 	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));
@@ -1083,7 +1308,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)
 	};
 }
@@ -1098,8 +1323,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}]`;
@@ -1155,17 +1381,35 @@ 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,
+		roomsPuttyWallArea: object.roomsPuttyWallArea ?? 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,
+			puttyRequired: sample.puttyRequired ?? true
+		} };
+	}
 	if (room === void 0 || product === void 0) return { error: {
 		code: "SAMPLE_INCOMPLETE",
 		params: { missing: room === void 0 ? "room" : "product" }
@@ -1181,15 +1425,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;
@@ -1215,7 +1465,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
@@ -1287,10 +1545,18 @@ 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("roomsPuttyWallArea"),
+		number("roomsPerimeter"),
+		number("wetRoomsCount")
 	]
 };
 const FORMULA_QUANTITY_VARIABLE = number("quantity");
+const FORMULA_SURFACE_AREA_VARIABLE = number("surfaceArea");
+const FORMULA_PUTTY_REQUIRED_VARIABLE = boolean("puttyRequired");
 const FORMULA_VARIABLES = {
 	OBJECT: FORMULA_SCOPE_VARIABLES.object,
 	CATEGORY: [
@@ -1302,9 +1568,15 @@ 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,
+		FORMULA_PUTTY_REQUIRED_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,
@@ -1328,7 +1600,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",
@@ -1516,4 +1788,4 @@ function validateFormula(input) {
 	};
 }
 //#endregion
-export { BaseRateSchema, COEFFICIENT_NAMESPACE, CentsSchema, ConfigurationSchema, CurrencySchema, EstimateLineSchema, EstimateMessageSchema, EstimateSchema, EstimateTotalsSchema, EstimateWarningSchema, ExchangeRateSchema, FORMULA_FUNCTIONS, FORMULA_FUNCTION_TABLE, FORMULA_LIMITS, FORMULA_QUANTITY_VARIABLE, FORMULA_SCOPE_VARIABLES, FORMULA_VARIABLES, FinishLevelSchema, LineStatusSchema, LocalizedTextSchema, OptionCodeSchema, OptionKindSchema, OptionSelectionSchema, OptionUnitSchema, PricingCategorySchema, PricingDataSchema, PricingLimitsSchema, PricingMaterialTypeSchema, PricingOptionSchema, PricingPackageItemSchema, PricingProductSchema, PricingRoomTypeSchema, PricingRuleSchema, ProductUnitSchema, RangeSchema, RateSourceSchema, RoomConfigurationSchema, RoomSelectionSchema, RoomTypeCodeSchema, RuleLevelSchema, RulePreviewSchema, RuleSampleSchema, SectionSchema, SectionTotalSchema, SurfaceKindSchema, checkLimits, convertCentsToKopecks, estimate, evaluate, levenshtein, objectVariables, parse, previewRule, productVariables, productVariablesOf, roomVariables, suggestNearest, toCents, validateFormula };
+export { COEFFICIENT_NAMESPACE, CentsSchema, ConfigurationSchema, CurrencySchema, EstimateLineSchema, EstimateMessageSchema, EstimateSchema, EstimateTotalsSchema, EstimateWarningSchema, ExchangeRateSchema, FORMULA_FUNCTIONS, FORMULA_FUNCTION_TABLE, FORMULA_LIMITS, FORMULA_PUTTY_REQUIRED_VARIABLE, FORMULA_QUANTITY_VARIABLE, FORMULA_SCOPE_VARIABLES, FORMULA_SURFACE_AREA_VARIABLE, FORMULA_VARIABLES, FinishLevelSchema, LineComponentKindSchema, LineComponentSchema, LineStatusSchema, LocalizedTextSchema, OptionCodeSchema, OptionKindSchema, OptionSelectionSchema, OptionUnitSchema, PricingCategorySchema, PricingDataSchema, PricingLimitsSchema, PricingMaterialTypeSchema, PricingOptionSchema, PricingPackageItemSchema, PricingProductSchema, PricingRoomTypeSchema, PricingRuleSchema, ProductUnitSchema, RangeSchema, RateSourceSchema, RoomConfigurationSchema, RoomSelectionSchema, RoomTypeCodeSchema, RuleLevelSchema, RulePreviewSchema, RuleSampleSchema, ScopeSchema, SectionSchema, SectionTotalSchema, SurfaceKindSchema, checkLimits, convertCentsToKopecks, estimate, evaluate, findOptionPriceSourceViolation, levenshtein, objectVariables, parse, previewRule, productVariables, productVariablesOf, puttyRequiredOn, roomVariables, suggestNearest, toCents, totalAreaOf, validateFormula };