@roomwise/calc-engine 0.5.0 → 0.7.0

package/README.md

@@ -47,7 +47,7 @@ Lines are produced in this order: base cost, object rules (by `sortOrder`), mate
 - Base cost: `OBJECT` rules with `baseComponent: true`, one `BASE` line each. Only in `FULL`; a line that is `OK` with a zero amount is left out.
 - Object rules: the other `OBJECT` level rules, one line each.
 - Materials: for every room selection with a product, the `MATERIAL_TYPE` rule for the category and the product's material type is used if one exists, otherwise the `CATEGORY` rule. Without either, the line is `NOT_CALCULATED` (`RULE_NOT_FOUND`). Unknown or unavailable products give `UNAVAILABLE`. Each line carries [components](#line-components).
-- Engineering and additional: package items marked `includedInBase` become `INCLUDED` lines with a zero amount, and are skipped in `PARTIAL`. Options are priced by unit (`PIECE`, `ROOM_SQM`, `ROOM`, `PROJECT`). An option with `priceCoefficientKeys` is priced by the sum of those coefficients in dollars instead of `priceCents`; a missing coefficient gives an `ERROR` line (`UNKNOWN_COEFFICIENT`). An option whose `scopes` do not include the configuration scope is `UNAVAILABLE` with `OPTION_SCOPE_NOT_ALLOWED`.
+- Engineering and additional: package items marked `includedInBase` become `INCLUDED` lines with a zero amount, and are skipped in `PARTIAL`. Options are priced by unit (`PIECE`, `ROOM_SQM`, `ROOM`, `PROJECT`). An option has exactly one price source: `priceCents` with no `priceCoefficientKeys`, or `priceCents: null` with keys, in which case the unit price is the sum of those coefficients in dollars (`PricingDataSchema` rejects both and neither; read the price from the line's `unitPriceCents`). A missing coefficient gives an `ERROR` line (`UNKNOWN_COEFFICIENT`). An option whose `scopes` do not include the configuration scope is `UNAVAILABLE` with `OPTION_SCOPE_NOT_ALLOWED`.
 
 Result fields:
 
@@ -197,7 +197,7 @@ Every schema is a zod schema with an inferred type of the same name without the
 | `totalArea` variable | `totalAreaSqm` | `roomsFloorArea` |
 | Area warnings | `ROOMS_AREA_EXCEEDS_TOTAL`, `ROOMS_AREA_BELOW_TOTAL` | none |
 
-The base cost has no per-area rate table. It is built from rules whose formulas use the volumes of the rooms (`roomsFloorArea`, `roomsWallArea`, `roomsPerimeter`, `wetRoomsCount`) together with `finishLevel`, `scope` and coefficients.
+The base cost has no per-area rate table. It is built from rules whose formulas use the volumes of the rooms (`roomsFloorArea`, `roomsWallArea`, `roomsPuttyWallArea`, `roomsPerimeter`, `wetRoomsCount`) together with `finishLevel`, `scope` and coefficients.
 
 ### Line components
 
@@ -241,18 +241,20 @@ roomType == 'KITCHEN' ? ceil(floorArea / 2) : 0
 | object | `totalArea`, `balconyArea` | number; `totalArea` is `roomsFloorArea` in `PARTIAL` |
 | object | `scope` | `FULL`, `PARTIAL` |
 | object | `roomsFloorArea`, `roomsWallArea`, `roomsPerimeter` | number: sums over all rooms of `floorArea`, `wallArea` and `perimeter` |
+| object | `roomsPuttyWallArea` | number: sum of `wallArea` over rooms whose wall selections need putty (rooms without wall selections count) |
 | object | `wetRoomsCount` | number (bathrooms, kitchens and kitchen-living rooms) |
 | object | `balconyTiles` | boolean |
 | object | `finishLevel` | `ROUGH`, `PRE_FINISH`, `LIVED_IN` |
 | object | `roomsCount`, `bathroomsCount` | number (living rooms, bedrooms and kitchen-living rooms count as rooms) |
 | `SURFACE` rules only | `surfaceArea` | number: the area of the surface being prepared |
+| `SURFACE` rules only | `puttyRequired` | boolean: `true` when no category is selected on the surface or at least one selected category has `requiresPutty` (default `true`), taken from the selections, not from line status; booleans do not coerce, write `puttyRequired ? a : 0` |
 | cost and labor formulas of `CATEGORY` and `MATERIAL_TYPE` rules | `quantity` | the result of the quantity formula |
 
 Availability by rule level:
 
 - `OBJECT`: object variables only. `quantity` is not available.
 - `CATEGORY` and `MATERIAL_TYPE`: room, product and object variables. `quantity` is available in cost and labor formulas, not in the quantity formula. `laborFormula` sees the same variables as `costFormula`.
-- `SURFACE`: room and object variables plus `surfaceArea`. `quantity` and the product variables are not available.
+- `SURFACE`: room and object variables plus `surfaceArea` and `puttyRequired`. `quantity` and the product variables are not available.
 
 Coefficients are read as `coef.<key>`; keys come from the pricing data. The cost and labor formulas receive `quantity` unrounded, while the line shows it rounded to 3 decimals.
 

package/dist/index.cjs

@@ -52,6 +52,9 @@ function toCents(dollars) {
 }
 //#endregion
 //#region src/variables/room.ts
+function surfaceAreaOf(variables, surface) {
+	return surface === "WALLS" ? variables.wallArea : variables.floorArea;
+}
 function roomVariables(room) {
 	const perimeter = 2 * (room.lengthM + room.widthM);
 	return {
@@ -66,6 +69,63 @@ function roomVariables(room) {
 	};
 }
 //#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/share.ts
+function isShareSurface(surface) {
+	return surface === "WALLS" || surface === "FLOOR";
+}
+function surfaceShares(room, surface, categories) {
+	const selections = room.selections.filter((selection) => selection.productId !== null && categories.some((category) => category.id === selection.categoryId && category.surface === surface));
+	return {
+		selections,
+		shared: selections.some((selection) => selection.areaShare !== void 0),
+		complete: selections.every((selection) => selection.areaShare !== void 0),
+		totalPercent: selections.reduce((sum, selection) => sum + (selection.areaShare ?? 0), 0)
+	};
+}
+function areaShareOf(selection) {
+	return selection.areaShare === void 0 ? 1 : selection.areaShare / 100;
+}
+function areaShareError(room, selection, categories) {
+	const category = categories.find((item) => item.id === selection.categoryId);
+	if (category === void 0) return null;
+	if (!isShareSurface(category.surface)) return selection.areaShare === void 0 ? null : {
+		code: "AREA_SHARE_NOT_ALLOWED",
+		params: {
+			categoryId: category.id,
+			surface: category.surface
+		}
+	};
+	const shares = surfaceShares(room, category.surface, categories);
+	const params = {
+		roomClientId: room.clientId,
+		surface: category.surface
+	};
+	if (shares.shared && !shares.complete) return {
+		code: "AREA_SHARE_MISSING",
+		params
+	};
+	if (shares.totalPercent > 100) return {
+		code: "AREA_SHARE_EXCEEDS_SURFACE",
+		params: {
+			...params,
+			percent: shares.totalPercent
+		}
+	};
+	return null;
+}
+function puttyShareOn(room, surface, categories) {
+	const shares = surface === "WALLS" ? surfaceShares(room, surface, categories) : null;
+	if (shares === null || !shares.shared) return puttyRequiredOn(room, surface, categories) ? 1 : 0;
+	const needing = shares.selections.filter((selection) => categories.find((category) => category.id === selection.categoryId)?.requiresPutty);
+	return Math.min(1, needing.reduce((sum, selection) => sum + areaShareOf(selection), 0));
+}
+//#endregion
 //#region src/variables/object.ts
 const COUNTED_AS_ROOMS = [
 	"LIVING_ROOM",
@@ -80,7 +140,7 @@ const WET_ROOMS = [
 function totalAreaOf(scope, totalAreaSqm, roomsFloorArea) {
 	return scope === "PARTIAL" || totalAreaSqm === null ? roomsFloorArea : totalAreaSqm;
 }
-function objectVariables(configuration) {
+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);
@@ -94,6 +154,7 @@ function objectVariables(configuration) {
 		bathroomsCount: configuration.rooms.filter((room) => room.roomTypeCode === "BATHROOM").length,
 		roomsFloorArea,
 		roomsWallArea: sum((room) => room.wallArea),
+		roomsPuttyWallArea: configuration.rooms.reduce((total, room) => total + roomVariables(room).wallArea * puttyShareOn(room, "WALLS", categories), 0),
 		roomsPerimeter: sum((room) => room.perimeter),
 		wetRoomsCount: rooms.filter((room) => WET_ROOMS.includes(room.roomType)).length
 	};
@@ -726,23 +787,25 @@ function applySurfacePrep(data, room, lines, objectScope) {
 		...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]);
+		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 surfaceArea = surfaceAreaOf(variables, surface);
+		const puttyShare = puttyShareOn(room, surface, data.categories);
 		const outcome = runNumericFormula(rule.costFormula, {
 			variables: {
 				...variables,
-				surfaceArea: areas[surface]
+				surfaceArea,
+				puttyRequired: puttyShare > 0,
+				puttyArea: surfaceArea * puttyShare
 			},
 			coefficients: data.coefficients
 		});
@@ -775,7 +838,9 @@ 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, objectScope) {
+function materialLine(configuration, data, room, selection, objectScope) {
+	const { categoryId } = selection;
+	const productId = selection.productId;
 	const init = {
 		id: lineId("MATERIALS", room.clientId, categoryId),
 		section: "MATERIALS",
@@ -783,6 +848,8 @@ function materialLine(configuration, data, room, categoryId, productId, objectSc
 		categoryId,
 		productId
 	};
+	const shareError = areaShareError(room, selection, data.categories);
+	if (shareError !== null) return failedLine(init, "ERROR", shareError);
 	const category = data.categories.find((item) => item.id === categoryId);
 	const product = data.products.find((item) => item.id === productId && item.categoryId === categoryId);
 	if (product === void 0 || category === void 0 || !product.available) return failedLine(init, "UNAVAILABLE", {
@@ -804,8 +871,12 @@ function materialLine(configuration, data, room, categoryId, productId, objectSc
 			materialTypeId: product.materialTypeId
 		}
 	});
+	const base = roomVariables(room);
+	const share = areaShareOf(selection);
 	const variables = {
-		...roomVariables(room),
+		...base,
+		wallArea: category.surface === "WALLS" ? base.wallArea * share : base.wallArea,
+		floorArea: category.surface === "FLOOR" ? base.floorArea * share : base.floorArea,
 		...productVariables(product, category),
 		...objectScope
 	};
@@ -875,7 +946,7 @@ function materialLine(configuration, data, room, categoryId, productId, objectSc
 }
 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)]);
+		const lines = room.selections.flatMap((selection) => selection.productId === null ? [] : [materialLine(configuration, data, room, selection, objectScope)]);
 		return configuration.scope === "PARTIAL" ? applySurfacePrep(data, room, lines, objectScope) : lines;
 	});
 }
@@ -973,7 +1044,8 @@ const RangeSchema = zod.z.object({
 //#region src/schemas/configuration.ts
 const RoomSelectionSchema = zod.z.object({
 	categoryId: zod.z.string(),
-	productId: zod.z.string().nullable()
+	productId: zod.z.string().nullable(),
+	areaShare: zod.z.int().min(1).max(100).optional()
 });
 const RoomConfigurationSchema = zod.z.object({
 	clientId: zod.z.string(),
@@ -1077,7 +1149,8 @@ const PricingRoomTypeSchema = zod.z.object({
 const PricingCategorySchema = zod.z.object({
 	id: zod.z.string(),
 	wastePercent: zod.z.number().min(0),
-	surface: SurfaceKindSchema
+	surface: SurfaceKindSchema,
+	requiresPutty: zod.z.boolean().default(true)
 });
 const PricingMaterialTypeSchema = zod.z.object({
 	id: zod.z.string(),
@@ -1099,11 +1172,11 @@ const PricingPackageItemSchema = zod.z.object({
 	priceCents: CentsSchema.nullable(),
 	unit: OptionUnitSchema.nullable()
 });
-const PricingOptionSchema = zod.z.object({
+const PricingOptionObjectSchema = zod.z.object({
 	id: zod.z.string(),
 	code: OptionCodeSchema.nullable(),
 	kind: OptionKindSchema,
-	priceCents: CentsSchema,
+	priceCents: CentsSchema.nullable(),
 	unit: OptionUnitSchema,
 	roomTypeCodes: zod.z.array(zod.z.string()),
 	priceCoefficientKeys: zod.z.array(zod.z.string()),
@@ -1112,6 +1185,26 @@ const PricingOptionSchema = zod.z.object({
 	maxQuantity: zod.z.int().nullable(),
 	available: zod.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 = zod.z.object({
 	version: zod.z.string().regex(/^[0-9a-f]{16}$/),
 	exchangeRate: ExchangeRateSchema.nullable(),
@@ -1191,6 +1284,8 @@ const RuleSampleSchema = zod.z.object({
 		wastePercent: zod.z.number().min(0)
 	}).optional(),
 	surfaceArea: zod.z.number().min(0).optional(),
+	puttyRequired: zod.z.boolean().optional(),
+	puttyArea: zod.z.number().min(0).optional(),
 	object: zod.z.object({
 		scope: ScopeSchema,
 		totalAreaSqm: zod.z.number().positive().nullable(),
@@ -1201,6 +1296,7 @@ const RuleSampleSchema = zod.z.object({
 		bathroomsCount: zod.z.int().min(0),
 		roomsFloorArea: zod.z.number().min(0),
 		roomsWallArea: zod.z.number().min(0),
+		roomsPuttyWallArea: zod.z.number().min(0).optional(),
 		roomsPerimeter: zod.z.number().min(0),
 		wetRoomsCount: zod.z.int().min(0)
 	})
@@ -1268,10 +1364,32 @@ function roomsAreaWarnings(configuration, limits) {
 		params: { missingSqm }
 	}] : [];
 }
-function estimateWarnings(lines, configuration, rate, limits) {
+const SHARE_SURFACES = ["WALLS", "FLOOR"];
+function areaShareWarnings(configuration, categories) {
+	return configuration.rooms.flatMap((room) => {
+		const variables = roomVariables(room);
+		return SHARE_SURFACES.flatMap((surface) => {
+			const shares = surfaceShares(room, surface, categories);
+			if (!shares.shared || !shares.complete || shares.totalPercent >= 100) return [];
+			const percent = 100 - shares.totalPercent;
+			const area = surfaceAreaOf(variables, surface);
+			return [{
+				code: "AREA_SHARE_UNALLOCATED",
+				params: {
+					roomClientId: room.clientId,
+					surface,
+					percent,
+					sqm: roundArea(area * percent / 100)
+				}
+			}];
+		});
+	});
+}
+function estimateWarnings(lines, configuration, rate, data) {
 	return [
 		...collectWarnings(lines),
-		...roomsAreaWarnings(configuration, limits),
+		...roomsAreaWarnings(configuration, data.limits),
+		...areaShareWarnings(configuration, data.categories),
 		...configuration.currency === "UAH" && rate === null ? [{ code: "EXCHANGE_RATE_UNAVAILABLE" }] : []
 	];
 }
@@ -1285,7 +1403,7 @@ function withKopecks(line, rate) {
 }
 function estimate(configuration, data) {
 	const rate = data.exchangeRate?.rate ?? null;
-	const variables = objectVariables(configuration);
+	const variables = objectVariables(configuration, data.categories);
 	const lines = [
 		...objectRuleLines(configuration, data, "BASE", variables),
 		...objectRuleLines(configuration, data, "OBJECT", variables),
@@ -1299,7 +1417,7 @@ function estimate(configuration, data) {
 		exchangeRate: data.exchangeRate,
 		lines,
 		totals: computeTotals(lines, rate !== null),
-		warnings: estimateWarnings(lines, configuration, rate, data.limits),
+		warnings: estimateWarnings(lines, configuration, rate, data),
 		incomplete: isIncomplete(lines)
 	};
 }
@@ -1381,6 +1499,7 @@ function objectScope({ object }) {
 		bathroomsCount: object.bathroomsCount,
 		roomsFloorArea: object.roomsFloorArea,
 		roomsWallArea: object.roomsWallArea,
+		roomsPuttyWallArea: object.roomsPuttyWallArea ?? object.roomsWallArea,
 		roomsPerimeter: object.roomsPerimeter,
 		wetRoomsCount: object.wetRoomsCount
 	};
@@ -1393,10 +1512,13 @@ function scopeOf(level, sample) {
 			code: "SAMPLE_INCOMPLETE",
 			params: { missing: room === void 0 ? "room" : "surfaceArea" }
 		} };
+		const puttyRequired = sample.puttyRequired ?? true;
 		return { scope: {
 			...roomVariables(room),
 			...objectScope(sample),
-			surfaceArea
+			surfaceArea,
+			puttyRequired,
+			puttyArea: sample.puttyArea ?? (puttyRequired ? surfaceArea : 0)
 		} };
 	}
 	if (room === void 0 || product === void 0) return { error: {
@@ -1538,12 +1660,15 @@ const FORMULA_SCOPE_VARIABLES = {
 		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_AREA_VARIABLE = number("puttyArea");
+const FORMULA_PUTTY_REQUIRED_VARIABLE = boolean("puttyRequired");
 const FORMULA_VARIABLES = {
 	OBJECT: FORMULA_SCOPE_VARIABLES.object,
 	CATEGORY: [
@@ -1559,7 +1684,9 @@ const FORMULA_VARIABLES = {
 	SURFACE: [
 		...FORMULA_SCOPE_VARIABLES.room,
 		...FORMULA_SCOPE_VARIABLES.object,
-		FORMULA_SURFACE_AREA_VARIABLE
+		FORMULA_SURFACE_AREA_VARIABLE,
+		FORMULA_PUTTY_REQUIRED_VARIABLE,
+		FORMULA_PUTTY_AREA_VARIABLE
 	]
 };
 const ALL_VARIABLE_NAMES = new Set([...FORMULA_VARIABLES.CATEGORY, ...FORMULA_VARIABLES.SURFACE].map((variable) => variable.name));
@@ -1787,6 +1914,8 @@ exports.ExchangeRateSchema = ExchangeRateSchema;
 exports.FORMULA_FUNCTIONS = FORMULA_FUNCTIONS;
 exports.FORMULA_FUNCTION_TABLE = FORMULA_FUNCTION_TABLE;
 exports.FORMULA_LIMITS = FORMULA_LIMITS;
+exports.FORMULA_PUTTY_AREA_VARIABLE = FORMULA_PUTTY_AREA_VARIABLE;
+exports.FORMULA_PUTTY_REQUIRED_VARIABLE = FORMULA_PUTTY_REQUIRED_VARIABLE;
 exports.FORMULA_QUANTITY_VARIABLE = FORMULA_QUANTITY_VARIABLE;
 exports.FORMULA_SCOPE_VARIABLES = FORMULA_SCOPE_VARIABLES;
 exports.FORMULA_SURFACE_AREA_VARIABLE = FORMULA_SURFACE_AREA_VARIABLE;
@@ -1822,18 +1951,26 @@ exports.ScopeSchema = ScopeSchema;
 exports.SectionSchema = SectionSchema;
 exports.SectionTotalSchema = SectionTotalSchema;
 exports.SurfaceKindSchema = SurfaceKindSchema;
+exports.areaShareError = areaShareError;
+exports.areaShareOf = areaShareOf;
 exports.checkLimits = checkLimits;
 exports.convertCentsToKopecks = convertCentsToKopecks;
 exports.estimate = estimate;
 exports.evaluate = evaluate;
+exports.findOptionPriceSourceViolation = findOptionPriceSourceViolation;
+exports.isShareSurface = isShareSurface;
 exports.levenshtein = levenshtein;
 exports.objectVariables = objectVariables;
 exports.parse = parse;
 exports.previewRule = previewRule;
 exports.productVariables = productVariables;
 exports.productVariablesOf = productVariablesOf;
+exports.puttyRequiredOn = puttyRequiredOn;
+exports.puttyShareOn = puttyShareOn;
 exports.roomVariables = roomVariables;
 exports.suggestNearest = suggestNearest;
+exports.surfaceAreaOf = surfaceAreaOf;
+exports.surfaceShares = surfaceShares;
 exports.toCents = toCents;
 exports.totalAreaOf = totalAreaOf;
 exports.validateFormula = validateFormula;

package/dist/index.d.cts

@@ -29,10 +29,10 @@ export declare const RateSourceSchema: z.ZodEnum<{
 }>;
 export type RateSource = z.infer<typeof RateSourceSchema>;
 export declare const SurfaceKindSchema: z.ZodEnum<{
+  NONE: "NONE";
   FLOOR: "FLOOR";
   WALLS: "WALLS";
   CEILING: "CEILING";
-  NONE: "NONE";
 }>;
 export type SurfaceKind = z.infer<typeof SurfaceKindSchema>;
 export declare const ProductUnitSchema: z.ZodEnum<{
@@ -106,6 +106,7 @@ export type Range = z.infer<typeof RangeSchema>;
 export declare const RoomSelectionSchema: z.ZodObject<{
   categoryId: z.ZodString;
   productId: z.ZodNullable<z.ZodString>;
+  areaShare: z.ZodOptional<z.ZodInt>;
 }, z.core.$strip>;
 export type RoomSelection = z.infer<typeof RoomSelectionSchema>;
 export declare const RoomConfigurationSchema: z.ZodObject<{
@@ -127,6 +128,7 @@ export declare const RoomConfigurationSchema: z.ZodObject<{
   selections: z.ZodArray<z.ZodObject<{
     categoryId: z.ZodString;
     productId: z.ZodNullable<z.ZodString>;
+    areaShare: z.ZodOptional<z.ZodInt>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 export type RoomConfiguration = z.infer<typeof RoomConfigurationSchema>;
@@ -168,6 +170,7 @@ export declare const ConfigurationSchema: z.ZodObject<{
     selections: z.ZodArray<z.ZodObject<{
       categoryId: z.ZodString;
       productId: z.ZodNullable<z.ZodString>;
+      areaShare: z.ZodOptional<z.ZodInt>;
     }, z.core.$strip>>;
   }, z.core.$strip>>;
   options: z.ZodArray<z.ZodObject<{
@@ -382,6 +385,8 @@ export declare const RuleSampleSchema: z.ZodObject<{
     wastePercent: z.ZodNumber;
   }, z.core.$strip>>;
   surfaceArea: z.ZodOptional<z.ZodNumber>;
+  puttyRequired: z.ZodOptional<z.ZodBoolean>;
+  puttyArea: z.ZodOptional<z.ZodNumber>;
   object: z.ZodObject<{
     scope: z.ZodEnum<{
       FULL: "FULL";
@@ -399,6 +404,7 @@ export declare const RuleSampleSchema: z.ZodObject<{
     bathroomsCount: z.ZodInt;
     roomsFloorArea: z.ZodNumber;
     roomsWallArea: z.ZodNumber;
+    roomsPuttyWallArea: z.ZodOptional<z.ZodNumber>;
     roomsPerimeter: z.ZodNumber;
     wetRoomsCount: z.ZodInt;
   }, z.core.$strip>;
@@ -482,11 +488,12 @@ export declare const PricingCategorySchema: z.ZodObject<{
   id: z.ZodString;
   wastePercent: z.ZodNumber;
   surface: z.ZodEnum<{
+    NONE: "NONE";
     FLOOR: "FLOOR";
     WALLS: "WALLS";
     CEILING: "CEILING";
-    NONE: "NONE";
   }>;
+  requiresPutty: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type PricingCategory = z.infer<typeof PricingCategorySchema>;
 export declare const PricingMaterialTypeSchema: z.ZodObject<{
@@ -521,6 +528,10 @@ export declare const PricingPackageItemSchema: z.ZodObject<{
   }>>;
 }, z.core.$strip>;
 export type PricingPackageItem = z.infer<typeof PricingPackageItemSchema>;
+export declare function findOptionPriceSourceViolation(priceCents: number | null, priceCoefficientKeys: readonly string[]): {
+  path: 'priceCents' | 'priceCoefficientKeys';
+  message: string;
+} | null;
 export declare const PricingOptionSchema: z.ZodObject<{
   id: z.ZodString;
   code: z.ZodNullable<z.ZodEnum<{
@@ -530,7 +541,7 @@ export declare const PricingOptionSchema: z.ZodObject<{
     ENGINEERING: "ENGINEERING";
     ADDITIONAL: "ADDITIONAL";
   }>;
-  priceCents: z.ZodInt;
+  priceCents: z.ZodNullable<z.ZodInt>;
   unit: z.ZodEnum<{
     PIECE: "PIECE";
     ROOM_SQM: "ROOM_SQM";
@@ -611,11 +622,12 @@ export declare const PricingDataSchema: z.ZodObject<{
     id: z.ZodString;
     wastePercent: z.ZodNumber;
     surface: z.ZodEnum<{
+      NONE: "NONE";
       FLOOR: "FLOOR";
       WALLS: "WALLS";
       CEILING: "CEILING";
-      NONE: "NONE";
     }>;
+    requiresPutty: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>;
   materialTypes: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
@@ -655,7 +667,7 @@ export declare const PricingDataSchema: z.ZodObject<{
       ENGINEERING: "ENGINEERING";
       ADDITIONAL: "ADDITIONAL";
     }>;
-    priceCents: z.ZodInt;
+    priceCents: z.ZodNullable<z.ZodInt>;
     unit: z.ZodEnum<{
       PIECE: "PIECE";
       ROOM_SQM: "ROOM_SQM";
@@ -812,6 +824,8 @@ export interface FormulaVariable {
 export declare const FORMULA_SCOPE_VARIABLES: Record<FormulaScope, readonly FormulaVariable[]>;
 export declare const FORMULA_QUANTITY_VARIABLE: FormulaVariable;
 export declare const FORMULA_SURFACE_AREA_VARIABLE: FormulaVariable;
+export declare const FORMULA_PUTTY_AREA_VARIABLE: FormulaVariable;
+export declare const FORMULA_PUTTY_REQUIRED_VARIABLE: FormulaVariable;
 export declare const FORMULA_VARIABLES: Record<RuleLevel, readonly FormulaVariable[]>;
 export interface ValidateFormulaInput {
   readonly level: RuleLevel;
@@ -843,11 +857,12 @@ export interface ObjectVariables {
   readonly bathroomsCount: number;
   readonly roomsFloorArea: number;
   readonly roomsWallArea: number;
+  readonly roomsPuttyWallArea: number;
   readonly roomsPerimeter: number;
   readonly wetRoomsCount: number;
 }
 export declare function totalAreaOf(scope: Scope, totalAreaSqm: number | null, roomsFloorArea: number): number;
-export declare function objectVariables(configuration: Configuration): ObjectVariables;
+export declare function objectVariables(configuration: Configuration, categories: readonly PricingCategory[]): ObjectVariables;
 //#endregion
 //#region src/variables/product.d.ts
 export interface ProductVariables {
@@ -858,6 +873,9 @@ export interface ProductVariables {
 export declare function productVariablesOf(product: Pick<PricingProduct, 'priceCents' | 'unit'>, wastePercent: number): ProductVariables;
 export declare function productVariables(product: PricingProduct, category: PricingCategory): ProductVariables;
 //#endregion
+//#region src/variables/putty.d.ts
+export declare function puttyRequiredOn(room: RoomConfiguration, surface: PricingCategory['surface'], categories: readonly PricingCategory[]): boolean;
+//#endregion
 //#region src/variables/room.d.ts
 export interface RoomVariables {
   readonly length: number;
@@ -869,6 +887,22 @@ export interface RoomVariables {
   readonly heatedFloor: boolean;
   readonly roomType: RoomTypeCode;
 }
+export type MeasuredSurface = 'FLOOR' | 'WALLS' | 'CEILING';
+export declare function surfaceAreaOf(variables: Pick<RoomVariables, 'floorArea' | 'wallArea'>, surface: MeasuredSurface): number;
 export type RoomDimensions = Pick<RoomConfiguration, 'roomTypeCode' | 'lengthM' | 'widthM' | 'heightM' | 'heatedFloor'>;
 export declare function roomVariables(room: RoomDimensions): RoomVariables;
+//#endregion
+//#region src/variables/share.d.ts
+export type ShareSurface = 'WALLS' | 'FLOOR';
+export interface SurfaceShares {
+  readonly selections: readonly RoomSelection[];
+  readonly shared: boolean;
+  readonly complete: boolean;
+  readonly totalPercent: number;
+}
+export declare function isShareSurface(surface: PricingCategory['surface']): surface is ShareSurface;
+export declare function surfaceShares(room: RoomConfiguration, surface: ShareSurface, categories: readonly PricingCategory[]): SurfaceShares;
+export declare function areaShareOf(selection: RoomSelection): number;
+export declare function areaShareError(room: RoomConfiguration, selection: RoomSelection, categories: readonly PricingCategory[]): EstimateMessage | null;
+export declare function puttyShareOn(room: RoomConfiguration, surface: MeasuredSurface, categories: readonly PricingCategory[]): number;
 //#endregion

package/dist/index.d.ts

@@ -29,10 +29,10 @@ export declare const RateSourceSchema: z.ZodEnum<{
 }>;
 export type RateSource = z.infer<typeof RateSourceSchema>;
 export declare const SurfaceKindSchema: z.ZodEnum<{
+  NONE: "NONE";
   FLOOR: "FLOOR";
   WALLS: "WALLS";
   CEILING: "CEILING";
-  NONE: "NONE";
 }>;
 export type SurfaceKind = z.infer<typeof SurfaceKindSchema>;
 export declare const ProductUnitSchema: z.ZodEnum<{
@@ -106,6 +106,7 @@ export type Range = z.infer<typeof RangeSchema>;
 export declare const RoomSelectionSchema: z.ZodObject<{
   categoryId: z.ZodString;
   productId: z.ZodNullable<z.ZodString>;
+  areaShare: z.ZodOptional<z.ZodInt>;
 }, z.core.$strip>;
 export type RoomSelection = z.infer<typeof RoomSelectionSchema>;
 export declare const RoomConfigurationSchema: z.ZodObject<{
@@ -127,6 +128,7 @@ export declare const RoomConfigurationSchema: z.ZodObject<{
   selections: z.ZodArray<z.ZodObject<{
     categoryId: z.ZodString;
     productId: z.ZodNullable<z.ZodString>;
+    areaShare: z.ZodOptional<z.ZodInt>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 export type RoomConfiguration = z.infer<typeof RoomConfigurationSchema>;
@@ -168,6 +170,7 @@ export declare const ConfigurationSchema: z.ZodObject<{
     selections: z.ZodArray<z.ZodObject<{
       categoryId: z.ZodString;
       productId: z.ZodNullable<z.ZodString>;
+      areaShare: z.ZodOptional<z.ZodInt>;
     }, z.core.$strip>>;
   }, z.core.$strip>>;
   options: z.ZodArray<z.ZodObject<{
@@ -382,6 +385,8 @@ export declare const RuleSampleSchema: z.ZodObject<{
     wastePercent: z.ZodNumber;
   }, z.core.$strip>>;
   surfaceArea: z.ZodOptional<z.ZodNumber>;
+  puttyRequired: z.ZodOptional<z.ZodBoolean>;
+  puttyArea: z.ZodOptional<z.ZodNumber>;
   object: z.ZodObject<{
     scope: z.ZodEnum<{
       FULL: "FULL";
@@ -399,6 +404,7 @@ export declare const RuleSampleSchema: z.ZodObject<{
     bathroomsCount: z.ZodInt;
     roomsFloorArea: z.ZodNumber;
     roomsWallArea: z.ZodNumber;
+    roomsPuttyWallArea: z.ZodOptional<z.ZodNumber>;
     roomsPerimeter: z.ZodNumber;
     wetRoomsCount: z.ZodInt;
   }, z.core.$strip>;
@@ -482,11 +488,12 @@ export declare const PricingCategorySchema: z.ZodObject<{
   id: z.ZodString;
   wastePercent: z.ZodNumber;
   surface: z.ZodEnum<{
+    NONE: "NONE";
     FLOOR: "FLOOR";
     WALLS: "WALLS";
     CEILING: "CEILING";
-    NONE: "NONE";
   }>;
+  requiresPutty: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type PricingCategory = z.infer<typeof PricingCategorySchema>;
 export declare const PricingMaterialTypeSchema: z.ZodObject<{
@@ -521,6 +528,10 @@ export declare const PricingPackageItemSchema: z.ZodObject<{
   }>>;
 }, z.core.$strip>;
 export type PricingPackageItem = z.infer<typeof PricingPackageItemSchema>;
+export declare function findOptionPriceSourceViolation(priceCents: number | null, priceCoefficientKeys: readonly string[]): {
+  path: 'priceCents' | 'priceCoefficientKeys';
+  message: string;
+} | null;
 export declare const PricingOptionSchema: z.ZodObject<{
   id: z.ZodString;
   code: z.ZodNullable<z.ZodEnum<{
@@ -530,7 +541,7 @@ export declare const PricingOptionSchema: z.ZodObject<{
     ENGINEERING: "ENGINEERING";
     ADDITIONAL: "ADDITIONAL";
   }>;
-  priceCents: z.ZodInt;
+  priceCents: z.ZodNullable<z.ZodInt>;
   unit: z.ZodEnum<{
     PIECE: "PIECE";
     ROOM_SQM: "ROOM_SQM";
@@ -611,11 +622,12 @@ export declare const PricingDataSchema: z.ZodObject<{
     id: z.ZodString;
     wastePercent: z.ZodNumber;
     surface: z.ZodEnum<{
+      NONE: "NONE";
       FLOOR: "FLOOR";
       WALLS: "WALLS";
       CEILING: "CEILING";
-      NONE: "NONE";
     }>;
+    requiresPutty: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>;
   materialTypes: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
@@ -655,7 +667,7 @@ export declare const PricingDataSchema: z.ZodObject<{
       ENGINEERING: "ENGINEERING";
       ADDITIONAL: "ADDITIONAL";
     }>;
-    priceCents: z.ZodInt;
+    priceCents: z.ZodNullable<z.ZodInt>;
     unit: z.ZodEnum<{
       PIECE: "PIECE";
       ROOM_SQM: "ROOM_SQM";
@@ -812,6 +824,8 @@ export interface FormulaVariable {
 export declare const FORMULA_SCOPE_VARIABLES: Record<FormulaScope, readonly FormulaVariable[]>;
 export declare const FORMULA_QUANTITY_VARIABLE: FormulaVariable;
 export declare const FORMULA_SURFACE_AREA_VARIABLE: FormulaVariable;
+export declare const FORMULA_PUTTY_AREA_VARIABLE: FormulaVariable;
+export declare const FORMULA_PUTTY_REQUIRED_VARIABLE: FormulaVariable;
 export declare const FORMULA_VARIABLES: Record<RuleLevel, readonly FormulaVariable[]>;
 export interface ValidateFormulaInput {
   readonly level: RuleLevel;
@@ -843,11 +857,12 @@ export interface ObjectVariables {
   readonly bathroomsCount: number;
   readonly roomsFloorArea: number;
   readonly roomsWallArea: number;
+  readonly roomsPuttyWallArea: number;
   readonly roomsPerimeter: number;
   readonly wetRoomsCount: number;
 }
 export declare function totalAreaOf(scope: Scope, totalAreaSqm: number | null, roomsFloorArea: number): number;
-export declare function objectVariables(configuration: Configuration): ObjectVariables;
+export declare function objectVariables(configuration: Configuration, categories: readonly PricingCategory[]): ObjectVariables;
 //#endregion
 //#region src/variables/product.d.ts
 export interface ProductVariables {
@@ -858,6 +873,9 @@ export interface ProductVariables {
 export declare function productVariablesOf(product: Pick<PricingProduct, 'priceCents' | 'unit'>, wastePercent: number): ProductVariables;
 export declare function productVariables(product: PricingProduct, category: PricingCategory): ProductVariables;
 //#endregion
+//#region src/variables/putty.d.ts
+export declare function puttyRequiredOn(room: RoomConfiguration, surface: PricingCategory['surface'], categories: readonly PricingCategory[]): boolean;
+//#endregion
 //#region src/variables/room.d.ts
 export interface RoomVariables {
   readonly length: number;
@@ -869,6 +887,22 @@ export interface RoomVariables {
   readonly heatedFloor: boolean;
   readonly roomType: RoomTypeCode;
 }
+export type MeasuredSurface = 'FLOOR' | 'WALLS' | 'CEILING';
+export declare function surfaceAreaOf(variables: Pick<RoomVariables, 'floorArea' | 'wallArea'>, surface: MeasuredSurface): number;
 export type RoomDimensions = Pick<RoomConfiguration, 'roomTypeCode' | 'lengthM' | 'widthM' | 'heightM' | 'heatedFloor'>;
 export declare function roomVariables(room: RoomDimensions): RoomVariables;
+//#endregion
+//#region src/variables/share.d.ts
+export type ShareSurface = 'WALLS' | 'FLOOR';
+export interface SurfaceShares {
+  readonly selections: readonly RoomSelection[];
+  readonly shared: boolean;
+  readonly complete: boolean;
+  readonly totalPercent: number;
+}
+export declare function isShareSurface(surface: PricingCategory['surface']): surface is ShareSurface;
+export declare function surfaceShares(room: RoomConfiguration, surface: ShareSurface, categories: readonly PricingCategory[]): SurfaceShares;
+export declare function areaShareOf(selection: RoomSelection): number;
+export declare function areaShareError(room: RoomConfiguration, selection: RoomSelection, categories: readonly PricingCategory[]): EstimateMessage | null;
+export declare function puttyShareOn(room: RoomConfiguration, surface: MeasuredSurface, categories: readonly PricingCategory[]): number;
 //#endregion

package/dist/index.js

@@ -27,6 +27,9 @@ function toCents(dollars) {
 }
 //#endregion
 //#region src/variables/room.ts
+function surfaceAreaOf(variables, surface) {
+	return surface === "WALLS" ? variables.wallArea : variables.floorArea;
+}
 function roomVariables(room) {
 	const perimeter = 2 * (room.lengthM + room.widthM);
 	return {
@@ -41,6 +44,63 @@ function roomVariables(room) {
 	};
 }
 //#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/share.ts
+function isShareSurface(surface) {
+	return surface === "WALLS" || surface === "FLOOR";
+}
+function surfaceShares(room, surface, categories) {
+	const selections = room.selections.filter((selection) => selection.productId !== null && categories.some((category) => category.id === selection.categoryId && category.surface === surface));
+	return {
+		selections,
+		shared: selections.some((selection) => selection.areaShare !== void 0),
+		complete: selections.every((selection) => selection.areaShare !== void 0),
+		totalPercent: selections.reduce((sum, selection) => sum + (selection.areaShare ?? 0), 0)
+	};
+}
+function areaShareOf(selection) {
+	return selection.areaShare === void 0 ? 1 : selection.areaShare / 100;
+}
+function areaShareError(room, selection, categories) {
+	const category = categories.find((item) => item.id === selection.categoryId);
+	if (category === void 0) return null;
+	if (!isShareSurface(category.surface)) return selection.areaShare === void 0 ? null : {
+		code: "AREA_SHARE_NOT_ALLOWED",
+		params: {
+			categoryId: category.id,
+			surface: category.surface
+		}
+	};
+	const shares = surfaceShares(room, category.surface, categories);
+	const params = {
+		roomClientId: room.clientId,
+		surface: category.surface
+	};
+	if (shares.shared && !shares.complete) return {
+		code: "AREA_SHARE_MISSING",
+		params
+	};
+	if (shares.totalPercent > 100) return {
+		code: "AREA_SHARE_EXCEEDS_SURFACE",
+		params: {
+			...params,
+			percent: shares.totalPercent
+		}
+	};
+	return null;
+}
+function puttyShareOn(room, surface, categories) {
+	const shares = surface === "WALLS" ? surfaceShares(room, surface, categories) : null;
+	if (shares === null || !shares.shared) return puttyRequiredOn(room, surface, categories) ? 1 : 0;
+	const needing = shares.selections.filter((selection) => categories.find((category) => category.id === selection.categoryId)?.requiresPutty);
+	return Math.min(1, needing.reduce((sum, selection) => sum + areaShareOf(selection), 0));
+}
+//#endregion
 //#region src/variables/object.ts
 const COUNTED_AS_ROOMS = [
 	"LIVING_ROOM",
@@ -55,7 +115,7 @@ const WET_ROOMS = [
 function totalAreaOf(scope, totalAreaSqm, roomsFloorArea) {
 	return scope === "PARTIAL" || totalAreaSqm === null ? roomsFloorArea : totalAreaSqm;
 }
-function objectVariables(configuration) {
+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);
@@ -69,6 +129,7 @@ function objectVariables(configuration) {
 		bathroomsCount: configuration.rooms.filter((room) => room.roomTypeCode === "BATHROOM").length,
 		roomsFloorArea,
 		roomsWallArea: sum((room) => room.wallArea),
+		roomsPuttyWallArea: configuration.rooms.reduce((total, room) => total + roomVariables(room).wallArea * puttyShareOn(room, "WALLS", categories), 0),
 		roomsPerimeter: sum((room) => room.perimeter),
 		wetRoomsCount: rooms.filter((room) => WET_ROOMS.includes(room.roomType)).length
 	};
@@ -701,23 +762,25 @@ function applySurfacePrep(data, room, lines, objectScope) {
 		...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]);
+		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 surfaceArea = surfaceAreaOf(variables, surface);
+		const puttyShare = puttyShareOn(room, surface, data.categories);
 		const outcome = runNumericFormula(rule.costFormula, {
 			variables: {
 				...variables,
-				surfaceArea: areas[surface]
+				surfaceArea,
+				puttyRequired: puttyShare > 0,
+				puttyArea: surfaceArea * puttyShare
 			},
 			coefficients: data.coefficients
 		});
@@ -750,7 +813,9 @@ 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, objectScope) {
+function materialLine(configuration, data, room, selection, objectScope) {
+	const { categoryId } = selection;
+	const productId = selection.productId;
 	const init = {
 		id: lineId("MATERIALS", room.clientId, categoryId),
 		section: "MATERIALS",
@@ -758,6 +823,8 @@ function materialLine(configuration, data, room, categoryId, productId, objectSc
 		categoryId,
 		productId
 	};
+	const shareError = areaShareError(room, selection, data.categories);
+	if (shareError !== null) return failedLine(init, "ERROR", shareError);
 	const category = data.categories.find((item) => item.id === categoryId);
 	const product = data.products.find((item) => item.id === productId && item.categoryId === categoryId);
 	if (product === void 0 || category === void 0 || !product.available) return failedLine(init, "UNAVAILABLE", {
@@ -779,8 +846,12 @@ function materialLine(configuration, data, room, categoryId, productId, objectSc
 			materialTypeId: product.materialTypeId
 		}
 	});
+	const base = roomVariables(room);
+	const share = areaShareOf(selection);
 	const variables = {
-		...roomVariables(room),
+		...base,
+		wallArea: category.surface === "WALLS" ? base.wallArea * share : base.wallArea,
+		floorArea: category.surface === "FLOOR" ? base.floorArea * share : base.floorArea,
 		...productVariables(product, category),
 		...objectScope
 	};
@@ -850,7 +921,7 @@ function materialLine(configuration, data, room, categoryId, productId, objectSc
 }
 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)]);
+		const lines = room.selections.flatMap((selection) => selection.productId === null ? [] : [materialLine(configuration, data, room, selection, objectScope)]);
 		return configuration.scope === "PARTIAL" ? applySurfacePrep(data, room, lines, objectScope) : lines;
 	});
 }
@@ -948,7 +1019,8 @@ const RangeSchema = z.object({
 //#region src/schemas/configuration.ts
 const RoomSelectionSchema = z.object({
 	categoryId: z.string(),
-	productId: z.string().nullable()
+	productId: z.string().nullable(),
+	areaShare: z.int().min(1).max(100).optional()
 });
 const RoomConfigurationSchema = z.object({
 	clientId: z.string(),
@@ -1052,7 +1124,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(),
@@ -1074,11 +1147,11 @@ 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()),
@@ -1087,6 +1160,26 @@ const PricingOptionSchema = z.object({
 	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(),
@@ -1166,6 +1259,8 @@ const RuleSampleSchema = z.object({
 		wastePercent: z.number().min(0)
 	}).optional(),
 	surfaceArea: z.number().min(0).optional(),
+	puttyRequired: z.boolean().optional(),
+	puttyArea: z.number().min(0).optional(),
 	object: z.object({
 		scope: ScopeSchema,
 		totalAreaSqm: z.number().positive().nullable(),
@@ -1176,6 +1271,7 @@ const RuleSampleSchema = z.object({
 		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)
 	})
@@ -1243,10 +1339,32 @@ function roomsAreaWarnings(configuration, limits) {
 		params: { missingSqm }
 	}] : [];
 }
-function estimateWarnings(lines, configuration, rate, limits) {
+const SHARE_SURFACES = ["WALLS", "FLOOR"];
+function areaShareWarnings(configuration, categories) {
+	return configuration.rooms.flatMap((room) => {
+		const variables = roomVariables(room);
+		return SHARE_SURFACES.flatMap((surface) => {
+			const shares = surfaceShares(room, surface, categories);
+			if (!shares.shared || !shares.complete || shares.totalPercent >= 100) return [];
+			const percent = 100 - shares.totalPercent;
+			const area = surfaceAreaOf(variables, surface);
+			return [{
+				code: "AREA_SHARE_UNALLOCATED",
+				params: {
+					roomClientId: room.clientId,
+					surface,
+					percent,
+					sqm: roundArea(area * percent / 100)
+				}
+			}];
+		});
+	});
+}
+function estimateWarnings(lines, configuration, rate, data) {
 	return [
 		...collectWarnings(lines),
-		...roomsAreaWarnings(configuration, limits),
+		...roomsAreaWarnings(configuration, data.limits),
+		...areaShareWarnings(configuration, data.categories),
 		...configuration.currency === "UAH" && rate === null ? [{ code: "EXCHANGE_RATE_UNAVAILABLE" }] : []
 	];
 }
@@ -1260,7 +1378,7 @@ function withKopecks(line, rate) {
 }
 function estimate(configuration, data) {
 	const rate = data.exchangeRate?.rate ?? null;
-	const variables = objectVariables(configuration);
+	const variables = objectVariables(configuration, data.categories);
 	const lines = [
 		...objectRuleLines(configuration, data, "BASE", variables),
 		...objectRuleLines(configuration, data, "OBJECT", variables),
@@ -1274,7 +1392,7 @@ function estimate(configuration, data) {
 		exchangeRate: data.exchangeRate,
 		lines,
 		totals: computeTotals(lines, rate !== null),
-		warnings: estimateWarnings(lines, configuration, rate, data.limits),
+		warnings: estimateWarnings(lines, configuration, rate, data),
 		incomplete: isIncomplete(lines)
 	};
 }
@@ -1356,6 +1474,7 @@ function objectScope({ object }) {
 		bathroomsCount: object.bathroomsCount,
 		roomsFloorArea: object.roomsFloorArea,
 		roomsWallArea: object.roomsWallArea,
+		roomsPuttyWallArea: object.roomsPuttyWallArea ?? object.roomsWallArea,
 		roomsPerimeter: object.roomsPerimeter,
 		wetRoomsCount: object.wetRoomsCount
 	};
@@ -1368,10 +1487,13 @@ function scopeOf(level, sample) {
 			code: "SAMPLE_INCOMPLETE",
 			params: { missing: room === void 0 ? "room" : "surfaceArea" }
 		} };
+		const puttyRequired = sample.puttyRequired ?? true;
 		return { scope: {
 			...roomVariables(room),
 			...objectScope(sample),
-			surfaceArea
+			surfaceArea,
+			puttyRequired,
+			puttyArea: sample.puttyArea ?? (puttyRequired ? surfaceArea : 0)
 		} };
 	}
 	if (room === void 0 || product === void 0) return { error: {
@@ -1513,12 +1635,15 @@ const FORMULA_SCOPE_VARIABLES = {
 		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_AREA_VARIABLE = number("puttyArea");
+const FORMULA_PUTTY_REQUIRED_VARIABLE = boolean("puttyRequired");
 const FORMULA_VARIABLES = {
 	OBJECT: FORMULA_SCOPE_VARIABLES.object,
 	CATEGORY: [
@@ -1534,7 +1659,9 @@ const FORMULA_VARIABLES = {
 	SURFACE: [
 		...FORMULA_SCOPE_VARIABLES.room,
 		...FORMULA_SCOPE_VARIABLES.object,
-		FORMULA_SURFACE_AREA_VARIABLE
+		FORMULA_SURFACE_AREA_VARIABLE,
+		FORMULA_PUTTY_REQUIRED_VARIABLE,
+		FORMULA_PUTTY_AREA_VARIABLE
 	]
 };
 const ALL_VARIABLE_NAMES = new Set([...FORMULA_VARIABLES.CATEGORY, ...FORMULA_VARIABLES.SURFACE].map((variable) => variable.name));
@@ -1749,4 +1876,4 @@ function validateFormula(input) {
 	};
 }
 //#endregion
-export { 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_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, levenshtein, objectVariables, parse, previewRule, productVariables, productVariablesOf, roomVariables, suggestNearest, toCents, totalAreaOf, validateFormula };
+export { COEFFICIENT_NAMESPACE, CentsSchema, ConfigurationSchema, CurrencySchema, EstimateLineSchema, EstimateMessageSchema, EstimateSchema, EstimateTotalsSchema, EstimateWarningSchema, ExchangeRateSchema, FORMULA_FUNCTIONS, FORMULA_FUNCTION_TABLE, FORMULA_LIMITS, FORMULA_PUTTY_AREA_VARIABLE, 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, areaShareError, areaShareOf, checkLimits, convertCentsToKopecks, estimate, evaluate, findOptionPriceSourceViolation, isShareSurface, levenshtein, objectVariables, parse, previewRule, productVariables, productVariablesOf, puttyRequiredOn, puttyShareOn, roomVariables, suggestNearest, surfaceAreaOf, surfaceShares, toCents, totalAreaOf, validateFormula };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roomwise/calc-engine",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",