@pascal-app/core 0.8.0 → 0.9.2

package/dist/lib/zone-quantities.js

@@ -0,0 +1,183 @@
+import { sampleWallCenterline } from '../systems/wall/wall-curve';
+import { DEFAULT_WALL_HEIGHT } from '../systems/wall/wall-footprint';
+import { detectSpacesForLevel } from './space-detection';
+const BOUNDARY_TOLERANCE = 0.08;
+function pointDistance(a, b) {
+    return Math.hypot(a[0] - b[0], a[1] - b[1]);
+}
+function pointToSegmentDistance(point, start, end) {
+    const dx = end[0] - start[0];
+    const dy = end[1] - start[1];
+    const lengthSquared = dx * dx + dy * dy;
+    if (lengthSquared <= 1e-12)
+        return pointDistance(point, start);
+    const t = Math.max(0, Math.min(1, ((point[0] - start[0]) * dx + (point[1] - start[1]) * dy) / lengthSquared));
+    return pointDistance(point, [start[0] + t * dx, start[1] + t * dy]);
+}
+function pointToPolygonBoundaryDistance(point, polygon) {
+    let best = Number.POSITIVE_INFINITY;
+    for (let index = 0; index < polygon.length; index += 1) {
+        const start = polygon[index];
+        const end = polygon[(index + 1) % polygon.length];
+        if (!(start && end))
+            continue;
+        best = Math.min(best, pointToSegmentDistance(point, start, end));
+    }
+    return best;
+}
+function signedPolygonArea(polygon) {
+    let area = 0;
+    for (let index = 0; index < polygon.length; index += 1) {
+        const start = polygon[index];
+        const end = polygon[(index + 1) % polygon.length];
+        if (!(start && end))
+            continue;
+        area += start[0] * end[1] - end[0] * start[1];
+    }
+    return area / 2;
+}
+function polygonArea(polygon) {
+    return Math.abs(signedPolygonArea(polygon));
+}
+function polygonPerimeter(polygon) {
+    let perimeter = 0;
+    for (let index = 0; index < polygon.length; index += 1) {
+        const start = polygon[index];
+        const end = polygon[(index + 1) % polygon.length];
+        if (!(start && end))
+            continue;
+        perimeter += pointDistance(start, end);
+    }
+    return perimeter;
+}
+function polygonsDescribeSameRegion(a, b) {
+    if (a.length < 3 || b.length < 3)
+        return false;
+    const aArea = polygonArea(a);
+    const bArea = polygonArea(b);
+    const areaTolerance = Math.max(0.02, Math.max(aArea, bArea) * 0.01);
+    if (Math.abs(aArea - bArea) > areaTolerance)
+        return false;
+    return (a.every((point) => pointToPolygonBoundaryDistance(point, b) <= BOUNDARY_TOLERANCE) &&
+        b.every((point) => pointToPolygonBoundaryDistance(point, a) <= BOUNDARY_TOLERANCE));
+}
+function polygonSurfaceArea(polygon, holes = []) {
+    return Math.max(0, polygonArea(polygon) - holes.reduce((sum, hole) => sum + polygonArea(hole), 0));
+}
+function pointToPolylineDistance(point, polyline) {
+    let best = Number.POSITIVE_INFINITY;
+    for (let index = 0; index < polyline.length - 1; index += 1) {
+        const start = polyline[index];
+        const end = polyline[index + 1];
+        if (!(start && end))
+            continue;
+        best = Math.min(best, pointToSegmentDistance(point, start, end));
+    }
+    return best;
+}
+function wallForBoundarySegment(start, end, walls) {
+    const midpoint = [(start[0] + end[0]) / 2, (start[1] + end[1]) / 2];
+    let best = null;
+    for (const wall of walls) {
+        const centerline = sampleWallCenterline(wall, 32).map((point) => [point.x, point.y]);
+        const distances = [start, midpoint, end].map((point) => pointToPolylineDistance(point, centerline));
+        if (distances.some((distance) => distance > BOUNDARY_TOLERANCE))
+            continue;
+        const distance = distances.reduce((sum, value) => sum + value, 0);
+        if (!best || distance < best.distance)
+            best = { wall, distance };
+    }
+    return best?.wall ?? null;
+}
+function matchingSurfaceNodes(zone, nodes) {
+    return nodes.filter((node) => polygonsDescribeSameRegion(zone.polygon, node.polygon));
+}
+function unavailable(reason) {
+    return { status: 'unavailable', reason };
+}
+export function deriveZoneQuantityReport(zone, sceneNodes) {
+    const levelId = zone.parentId;
+    const levelNodes = levelId
+        ? Object.values(sceneNodes).filter((node) => node.parentId === levelId)
+        : [];
+    const walls = levelNodes.filter((node) => node.type === 'wall');
+    const slabs = matchingSurfaceNodes(zone, levelNodes.filter((node) => node.type === 'slab'));
+    const ceilings = matchingSurfaceNodes(zone, levelNodes.filter((node) => node.type === 'ceiling'));
+    const edgeLengths = zone.polygon.map((start, index) => {
+        const end = zone.polygon[(index + 1) % zone.polygon.length];
+        return end ? pointDistance(start, end) : 0;
+    });
+    const footprintArea = polygonArea(zone.polygon);
+    const perimeter = edgeLengths.reduce((sum, length) => sum + length, 0);
+    const matchingRoom = levelId
+        ? detectSpacesForLevel(levelId, walls).roomPolygons.find((polygon) => polygonsDescribeSameRegion(zone.polygon, polygon.map((point) => [point.x, point.y])))
+        : undefined;
+    const wallMatches = matchingRoom?.map((start, index) => {
+        const end = matchingRoom[(index + 1) % matchingRoom.length];
+        if (!end)
+            return null;
+        const tupleStart = [start.x, start.y];
+        const tupleEnd = [end.x, end.y];
+        const wall = wallForBoundarySegment(tupleStart, tupleEnd, walls);
+        if (!wall)
+            return null;
+        return { wall, length: pointDistance(tupleStart, tupleEnd) };
+    });
+    const allWallsProven = !!wallMatches && wallMatches.length > 0 && wallMatches.every(Boolean);
+    const boundaryWallIds = allWallsProven
+        ? [...new Set(wallMatches.map((match) => match.wall.id))]
+        : [];
+    const wallSurface = allWallsProven
+        ? {
+            status: 'available',
+            value: wallMatches.reduce((sum, match) => sum + match.length * (match.wall.height ?? DEFAULT_WALL_HEIGHT), 0),
+            note: 'Gross interior wall face before openings.',
+        }
+        : unavailable(matchingRoom
+            ? 'The closed boundary could not be assigned to every wall segment.'
+            : 'No matching closed wall loop was detected.');
+    const matchingSlab = slabs.length === 1 ? slabs[0] : undefined;
+    const floorSurface = matchingSlab
+        ? {
+            status: 'available',
+            value: polygonSurfaceArea(matchingSlab.polygon, matchingSlab.holes),
+            note: 'Matching slab surface after openings.',
+        }
+        : unavailable(slabs.length > 1
+            ? 'More than one slab matches this boundary.'
+            : 'No slab matches this zone boundary.');
+    const matchingCeiling = ceilings.length === 1 ? ceilings[0] : undefined;
+    let volume;
+    if (!matchingRoom) {
+        volume = unavailable('No matching closed wall loop was detected.');
+    }
+    else if (!matchingSlab) {
+        volume = unavailable(floorSurface.status === 'unavailable' ? floorSurface.reason : 'No floor.');
+    }
+    else if (!matchingCeiling) {
+        volume = unavailable(ceilings.length > 1
+            ? 'More than one ceiling matches this boundary.'
+            : 'No ceiling matches this zone boundary.');
+    }
+    else {
+        const clearHeight = matchingCeiling.height - matchingSlab.elevation;
+        volume =
+            Number.isFinite(clearHeight) && clearHeight > 0
+                ? {
+                    status: 'available',
+                    value: polygonSurfaceArea(matchingSlab.polygon, matchingSlab.holes) * clearHeight,
+                    note: 'Matching slab area multiplied by clear ceiling height.',
+                }
+                : unavailable('The matching ceiling is not above the slab surface.');
+    }
+    return {
+        classification: matchingRoom ? 'enclosed-room' : 'footprint',
+        footprintArea,
+        perimeter,
+        edgeLengths,
+        boundaryWallIds,
+        wallSurface,
+        floorSurface,
+        volume,
+    };
+}

package/dist/lib/zone-quantities.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=zone-quantities.test.d.ts.map

package/dist/lib/zone-quantities.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-quantities.test.d.ts","sourceRoot":"","sources":["../../src/lib/zone-quantities.test.ts"],"names":[],"mappings":""}

package/dist/lib/zone-quantities.test.js

@@ -0,0 +1,82 @@
+import { describe, expect, test } from 'bun:test';
+import { CeilingNode, SlabNode, WallNode, ZoneNode } from '../schema';
+import { deriveZoneQuantityReport } from './zone-quantities';
+const polygon = [
+    [0, 0],
+    [4, 0],
+    [4, 3],
+    [0, 3],
+];
+function sceneRecord(nodes) {
+    return Object.fromEntries(nodes.map((node) => [node.id, node]));
+}
+function roomNodes() {
+    const zone = ZoneNode.parse({ id: 'zone_room', name: 'Studio', parentId: 'level_main', polygon });
+    const slab = SlabNode.parse({ id: 'slab_room', parentId: 'level_main', polygon });
+    const ceiling = CeilingNode.parse({ id: 'ceiling_room', parentId: 'level_main', polygon });
+    const walls = polygon.map((start, index) => WallNode.parse({
+        id: `wall_${index}`,
+        parentId: 'level_main',
+        start,
+        end: polygon[(index + 1) % polygon.length],
+        height: 2.5,
+    }));
+    return { zone, slab, ceiling, walls };
+}
+describe('deriveZoneQuantityReport', () => {
+    test('derives room surfaces and volume only from matching enclosure geometry', () => {
+        const { zone, slab, ceiling, walls } = roomNodes();
+        const report = deriveZoneQuantityReport(zone, sceneRecord([zone, slab, ceiling, ...walls]));
+        expect(report.classification).toBe('enclosed-room');
+        expect(report.footprintArea).toBeCloseTo(12);
+        expect(report.perimeter).toBeCloseTo(14);
+        expect(report.boundaryWallIds).toHaveLength(4);
+        expect(report.wallSurface).toEqual({
+            status: 'available',
+            value: 35,
+            note: 'Gross interior wall face before openings.',
+        });
+        expect(report.floorSurface).toEqual({
+            status: 'available',
+            value: 12,
+            note: 'Matching slab surface after openings.',
+        });
+        expect(report.volume.status).toBe('available');
+        if (report.volume.status === 'available')
+            expect(report.volume.value).toBeCloseTo(29.4);
+    });
+    test('keeps standalone zones honest about unavailable room quantities', () => {
+        const zone = ZoneNode.parse({
+            id: 'zone_site',
+            name: 'Garden',
+            parentId: 'level_main',
+            polygon,
+        });
+        const report = deriveZoneQuantityReport(zone, sceneRecord([zone]));
+        expect(report.classification).toBe('footprint');
+        expect(report.footprintArea).toBeCloseTo(12);
+        expect(report.wallSurface.status).toBe('unavailable');
+        expect(report.floorSurface.status).toBe('unavailable');
+        expect(report.volume.status).toBe('unavailable');
+    });
+    test('subtracts matching slab openings from floor surface', () => {
+        const { zone, slab } = roomNodes();
+        const slabWithHole = SlabNode.parse({
+            ...slab,
+            holes: [
+                [
+                    [1, 1],
+                    [2, 1],
+                    [2, 2],
+                    [1, 2],
+                ],
+            ],
+        });
+        const report = deriveZoneQuantityReport(zone, sceneRecord([zone, slabWithHole]));
+        expect(report.floorSurface).toEqual({
+            status: 'available',
+            value: 11,
+            note: 'Matching slab surface after openings.',
+        });
+    });
+});

package/dist/material-library.d.ts

@@ -3,18 +3,37 @@ export type MaterialCatalogItem = {
     id: string;
     label: string;
     category: MaterialCategory;
+    /**
+     * Where this finish is appropriate. Absent = universal (e.g. flat colors).
+     * The paint picker may filter by the slot being painted; v1 shows everything.
+     */
+    surfaces?: MaterialSurface[];
     description?: string;
     previewThumbnailUrl?: string;
     previewColor?: string;
     preset: MaterialPresetPayload;
 };
-export declare const MATERIAL_CATEGORIES: readonly ["wood", "wallpaper", "parquet", "granite", "marble", "other"];
+export declare const MATERIAL_CATEGORIES: readonly ["colors", "wood", "stone", "brick", "tile", "concrete", "metal", "fabric", "leather", "roofing", "ground", "glass"];
 export type MaterialCategory = (typeof MATERIAL_CATEGORIES)[number];
+export declare const MATERIAL_SURFACES: readonly ["floor", "wall", "ceiling", "roof", "furniture", "outdoor"];
+export type MaterialSurface = (typeof MATERIAL_SURFACES)[number];
 export declare const MATERIAL_CATALOG: MaterialCatalogItem[];
 export declare function getMaterialsForCategory(category: MaterialCategory): MaterialCatalogItem[];
 export declare function getCatalogMaterialById(id?: string): MaterialCatalogItem | undefined;
 export declare const LIBRARY_MATERIAL_REF_PREFIX = "library:";
+export declare const SCENE_MATERIAL_REF_PREFIX = "scene:";
 export declare function toLibraryMaterialRef(id: string): string;
+export declare function toSceneMaterialRef(id: string): string;
 export declare function getLibraryMaterialIdFromRef(materialRef?: string | null): string | null;
+export declare function getSceneMaterialIdFromRef(materialRef?: string | null): string | null;
+export type MaterialRef = string;
+export type ParsedMaterialRef = {
+    kind: 'library';
+    id: string;
+} | {
+    kind: 'scene';
+    id: string;
+};
+export declare function parseMaterialRef(ref?: string | null): ParsedMaterialRef | null;
 export declare function getMaterialPresetByRef(materialRef?: string | null): MaterialPresetPayload | null;
 //# sourceMappingURL=material-library.d.ts.map

package/dist/material-library.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"material-library.d.ts","sourceRoot":"","sources":["../src/material-library.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,mBAAmB,CAAA;AAE1B,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,qBAAqB,CAAA;CAC9B,CAAA;AA4BD,eAAO,MAAM,mBAAmB,yEAOtB,CAAA;AACV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,EAiiBjD,CAAA;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,mBAAmB,EAAE,CAEzF;AAED,wBAAgB,sBAAsB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAGnF;AAED,eAAO,MAAM,2BAA2B,aAAa,CAAA;AAErD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,UAE9C;AAED,wBAAgB,2BAA2B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,iBAItE;AAED,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB,GAAG,IAAI,CAIhG"}
+{"version":3,"file":"material-library.d.ts","sourceRoot":"","sources":["../src/material-library.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,mBAAmB,CAAA;AAE1B,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,gBAAgB,CAAA;IAC1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,qBAAqB,CAAA;CAC9B,CAAA;AAuCD,eAAO,MAAM,mBAAmB,+HAatB,CAAA;AACV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,eAAO,MAAM,iBAAiB,uEAOpB,CAAA;AACV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhE,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,EAi+HjD,CAAA;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,mBAAmB,EAAE,CAEzF;AAED,wBAAgB,sBAAsB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAGnF;AAED,eAAO,MAAM,2BAA2B,aAAa,CAAA;AACrD,eAAO,MAAM,yBAAyB,WAAW,CAAA;AAEjD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,UAE9C;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,UAE5C;AAED,wBAAgB,2BAA2B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,iBAItE;AAED,wBAAgB,yBAAyB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAGpF;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/F,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,GAAG,IAAI,CAM9E;AAED,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB,GAAG,IAAI,CAIhG"}