@pascal-app/core 0.5.1 → 0.7.0

package/dist/schema/asset-url.js

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+/**
+ * Scheme allowlist for asset-like URLs embedded in scene graphs.
+ *
+ * Phase 3 security audit: `scan.url`, `guide.url`, `material.texture.url`, and
+ * `item.asset.src` were previously bare `z.string()`. That meant an
+ * attacker-crafted scene loaded in the editor could beacon to arbitrary URLs
+ * (e.g. `javascript:`, `file:///etc/passwd`, `http://169.254.169.254/...`).
+ *
+ * This validator rejects URLs that don't match the scheme allowlist below.
+ */
+const ALLOWED_SCHEMES = ['asset:', 'blob:', 'https:', 'data:image/'];
+/**
+ * Optional environment variable that narrows which `https:` origins are
+ * accepted. Set to a comma-separated list (e.g. `https://cdn.pascal.app`).
+ * When unset, any `https:` origin is permitted.
+ */
+export const ALLOWED_ORIGINS_ENV = 'PASCAL_ALLOWED_ASSET_ORIGINS';
+// Narrow access to the environment variable without requiring @types/node in
+// this package. The core package ships to both browser and Node contexts.
+function readAllowedOrigins() {
+    const g = globalThis;
+    const value = g.process?.env?.[ALLOWED_ORIGINS_ENV];
+    if (!value)
+        return undefined;
+    const list = value
+        .split(',')
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    return list.length > 0 ? list : undefined;
+}
+function isAllowedAssetUrl(url) {
+    if (typeof url !== 'string' || url.length === 0)
+        return false;
+    if (url.startsWith('asset://'))
+        return true; // internal handle
+    if (url.startsWith('blob:'))
+        return true; // in-memory reference
+    if (url.startsWith('data:image/'))
+        return true; // inline image only (never data:text/html)
+    if (url.startsWith('/'))
+        return true; // app-relative path
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:')
+            return false;
+        // http is only permitted for localhost development
+        if (parsed.protocol === 'http:' && !['localhost', '127.0.0.1'].includes(parsed.hostname)) {
+            return false;
+        }
+        // optional env-driven origin allowlist (only enforced for https URLs)
+        if (parsed.protocol === 'https:') {
+            const allowlist = readAllowedOrigins();
+            if (allowlist)
+                return allowlist.includes(parsed.origin);
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Zod validator for asset-style URL fields. Accepts:
+ * - `asset://…` internal handles
+ * - `blob:…` in-memory references
+ * - `data:image/…` inline images (not `data:text/html` or other types)
+ * - `/…` app-relative paths
+ * - `https://…` public URLs (optionally narrowed to an env allowlist)
+ * - `http://localhost[:port]/…` or `http://127.0.0.1/…` for local dev
+ *
+ * Rejects every other scheme, including `javascript:`, `file:`, `ftp:`,
+ * and `data:text/html`, as well as empty strings and non-URL garbage.
+ */
+export const AssetUrl = z.string().refine(isAllowedAssetUrl, {
+    message: 'URL must be asset://, blob:, data:image/, /path, or https://. http://localhost allowed for dev.',
+});
+// re-export the scheme allowlist for documentation / downstream validators
+export { ALLOWED_SCHEMES };

package/dist/schema/asset-url.test.d.ts

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

package/dist/schema/asset-url.test.d.ts.map

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

package/dist/schema/asset-url.test.js

@@ -0,0 +1,138 @@
+// @ts-expect-error — bun:test is provided by the Bun runtime; core does not
+// depend on @types/bun so the import type is unresolved at compile time.
+// The tsconfig in packages/core still emits this file; the @ts-expect-error
+// keeps the build green while letting `bun test` pick it up normally.
+import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
+import { ALLOWED_ORIGINS_ENV, AssetUrl } from './asset-url';
+function isValid(url) {
+    return AssetUrl.safeParse(url).success;
+}
+describe('AssetUrl', () => {
+    describe('allowed URLs', () => {
+        const cases = [
+            ['asset://abc', 'internal asset handle'],
+            ['asset://catalog/items/chair-1', 'nested asset handle'],
+            ['blob:http://example.com/uuid-1234', 'blob URL with http inner'],
+            ['blob:https://example.com/uuid-5678', 'blob URL with https inner'],
+            ['https://cdn.example.com/a.glb', 'https CDN URL'],
+            ['https://cdn.example.com/models/chair.glb?v=2', 'https URL with query string'],
+            ['http://localhost:3000/x', 'http localhost with port'],
+            ['http://localhost/x', 'http localhost without port'],
+            ['http://127.0.0.1:8080/texture.png', 'http 127.0.0.1 loopback'],
+            ['/public/a.glb', 'app-relative path'],
+            ['/material/wood1/albedoMap_basecolor.jpg', 'relative path deep'],
+            ['data:image/png;base64,AAA', 'inline PNG data URL'],
+            ['data:image/jpeg;base64,/9j/', 'inline JPEG data URL'],
+            ['data:image/webp;base64,UklGR', 'inline WebP data URL'],
+            ['data:image/svg+xml,%3Csvg%3E', 'inline SVG data URL'],
+        ];
+        for (const [url, label] of cases) {
+            test(`accepts ${label}: ${url}`, () => {
+                expect(isValid(url)).toBe(true);
+            });
+        }
+    });
+    describe('rejected URLs', () => {
+        const cases = [
+            ['javascript:alert(1)', 'javascript scheme'],
+            ['JAVASCRIPT:alert(1)', 'javascript scheme uppercase'],
+            ['file:///etc/passwd', 'file scheme'],
+            ['file://C:/Windows/System32/config', 'file scheme Windows'],
+            ['http://evil.com/', 'non-loopback http'],
+            ['http://example.com:3000/x', 'http on non-loopback host'],
+            ['http://169.254.169.254/latest/meta-data/', 'http on link-local (cloud metadata)'],
+            ['data:text/html,<script>alert(1)</script>', 'data text/html'],
+            ['data:application/javascript,alert(1)', 'data application/javascript'],
+            ['data:text/plain,hi', 'data text/plain'],
+            ['ftp://a.b.com', 'ftp scheme'],
+            ['ws://example.com/', 'websocket scheme'],
+            ['vbscript:msgbox', 'vbscript scheme'],
+            ['', 'empty string'],
+            ['not a url at all', 'non-url string'],
+            ['://missing-scheme', 'malformed'],
+        ];
+        for (const [url, label] of cases) {
+            test(`rejects ${label}: ${url}`, () => {
+                expect(isValid(url)).toBe(false);
+            });
+        }
+    });
+    describe(`env allowlist via ${ALLOWED_ORIGINS_ENV}`, () => {
+        const g = globalThis;
+        const original = g.process?.env?.[ALLOWED_ORIGINS_ENV];
+        beforeEach(() => {
+            if (g.process?.env)
+                delete g.process.env[ALLOWED_ORIGINS_ENV];
+        });
+        afterEach(() => {
+            if (!g.process?.env)
+                return;
+            if (original === undefined) {
+                delete g.process.env[ALLOWED_ORIGINS_ENV];
+            }
+            else {
+                g.process.env[ALLOWED_ORIGINS_ENV] = original;
+            }
+        });
+        test('single origin allowlist accepts matching https URL', () => {
+            if (!g.process?.env)
+                return; // browser-only runtime
+            g.process.env[ALLOWED_ORIGINS_ENV] = 'https://cdn.pascal.app';
+            expect(isValid('https://cdn.pascal.app/a.glb')).toBe(true);
+            expect(isValid('https://cdn.pascal.app/deep/path?q=1')).toBe(true);
+        });
+        test('single origin allowlist rejects non-matching https URL', () => {
+            if (!g.process?.env)
+                return;
+            g.process.env[ALLOWED_ORIGINS_ENV] = 'https://cdn.pascal.app';
+            expect(isValid('https://cdn.other.com/a.glb')).toBe(false);
+            expect(isValid('https://attacker.example.com/x')).toBe(false);
+        });
+        test('multi-origin allowlist accepts any listed origin', () => {
+            if (!g.process?.env)
+                return;
+            g.process.env[ALLOWED_ORIGINS_ENV] = 'https://cdn.pascal.app, https://assets.pascal.app';
+            expect(isValid('https://cdn.pascal.app/a.glb')).toBe(true);
+            expect(isValid('https://assets.pascal.app/tex.webp')).toBe(true);
+            expect(isValid('https://third.example.com/x')).toBe(false);
+        });
+        test('allowlist ignores trailing / in URL path (origin match only)', () => {
+            if (!g.process?.env)
+                return;
+            g.process.env[ALLOWED_ORIGINS_ENV] = 'https://cdn.pascal.app';
+            expect(isValid('https://cdn.pascal.app/')).toBe(true);
+            expect(isValid('https://cdn.pascal.app')).toBe(true);
+        });
+        test('empty allowlist behaves like unset', () => {
+            if (!g.process?.env)
+                return;
+            g.process.env[ALLOWED_ORIGINS_ENV] = '';
+            expect(isValid('https://cdn.other.com/a.glb')).toBe(true);
+        });
+        test('allowlist does not restrict non-https schemes', () => {
+            if (!g.process?.env)
+                return;
+            g.process.env[ALLOWED_ORIGINS_ENV] = 'https://cdn.pascal.app';
+            // these should still pass because they match earlier scheme-based branches
+            expect(isValid('asset://x')).toBe(true);
+            expect(isValid('blob:https://example.com/abc')).toBe(true);
+            expect(isValid('data:image/png;base64,AAA')).toBe(true);
+            expect(isValid('/public/a.glb')).toBe(true);
+            expect(isValid('http://localhost:3000/x')).toBe(true);
+        });
+        test('allowlist rejects subdomain spoofing', () => {
+            if (!g.process?.env)
+                return;
+            g.process.env[ALLOWED_ORIGINS_ENV] = 'https://cdn.pascal.app';
+            expect(isValid('https://cdn.pascal.app.evil.com/x')).toBe(false);
+            expect(isValid('https://evil.com/cdn.pascal.app')).toBe(false);
+        });
+        test('allowlist respects ports', () => {
+            if (!g.process?.env)
+                return;
+            g.process.env[ALLOWED_ORIGINS_ENV] = 'https://cdn.pascal.app:8443';
+            expect(isValid('https://cdn.pascal.app:8443/x')).toBe(true);
+            expect(isValid('https://cdn.pascal.app/x')).toBe(false);
+        });
+    });
+});

package/dist/schema/index.d.ts

@@ -1,24 +1,31 @@
 export { BaseNode, generateId, Material, nodeType, objectId } from './base';
 export { CameraSchema } from './camera';
 export { type Collection, type CollectionId, generateCollectionId } from './collections';
-export { DEFAULT_MATERIALS, MaterialPreset, MaterialProperties, MaterialSchema, resolveMaterial, } from './material';
+export type { MaterialMapProperties, MaterialMaps, MaterialPresetPayload, MaterialTarget as MaterialTargetValue, TextureWrapMode as TextureWrapModeValue, } from './material';
+export { DEFAULT_MATERIALS, MaterialMapPropertiesSchema, MaterialMapsSchema, MaterialPreset, MaterialPresetPayloadSchema, MaterialProperties, MaterialSchema, MaterialTarget, resolveMaterial, TextureWrapMode, } from './material';
 export { BuildingNode } from './nodes/building';
 export { CeilingNode } from './nodes/ceiling';
+export { COLUMN_PRESETS, ColumnBaseStyle, ColumnCapitalStyle, ColumnCarvingPlacement, ColumnCrossSection, ColumnNode, ColumnPanelShape, type ColumnPresetId, ColumnRingPlacement, ColumnShaftDetail, ColumnShaftProfile, ColumnStyle, } from './nodes/column';
 export { DoorNode, DoorSegment } from './nodes/door';
 export { FenceBaseStyle, FenceNode, FenceStyle } from './nodes/fence';
-export { GuideNode } from './nodes/guide';
+export { GuideNode, GuideScaleReference } from './nodes/guide';
 export type { AnimationEffect, Asset, AssetInput, Control, Effect, Interactive, LightEffect, SliderControl, TemperatureControl, ToggleControl, } from './nodes/item';
-export { getScaledDimensions, ItemNode } from './nodes/item';
+export { getScaledDimensions, ItemNode, isLowProfileItemSurface, LOW_PROFILE_ITEM_SURFACE_MAX_HEIGHT, } from './nodes/item';
 export { LevelNode } from './nodes/level';
-export { RoofNode } from './nodes/roof';
+export type { RoofSurfaceMaterialRole, RoofSurfaceMaterialSpec } from './nodes/roof';
+export { getEffectiveRoofSurfaceMaterial, RoofNode } from './nodes/roof';
 export { RoofSegmentNode, RoofType } from './nodes/roof-segment';
 export { ScanNode } from './nodes/scan';
 export { SiteNode } from './nodes/site';
 export { SlabNode } from './nodes/slab';
-export { StairNode, StairRailingMode, StairTopLandingMode, StairType } from './nodes/stair';
+export { SpawnNode } from './nodes/spawn';
+export type { StairSurfaceMaterialRole, StairSurfaceMaterialSpec } from './nodes/stair';
+export { getEffectiveStairSurfaceMaterial, StairNode, StairRailingMode, StairSlabOpeningMode, StairTopLandingMode, StairType, } from './nodes/stair';
 export { AttachmentSide, StairSegmentNode, StairSegmentType } from './nodes/stair-segment';
-export { WallNode } from './nodes/wall';
-export { WindowNode } from './nodes/window';
+export { SurfaceHoleMetadata } from './nodes/surface-hole-metadata';
+export type { WallSurfaceMaterialSpec, WallSurfaceSide } from './nodes/wall';
+export { getEffectiveWallSurfaceMaterial, getWallSurfaceMaterialSignature, WallNode, } from './nodes/wall';
+export { WindowNode, WindowType } from './nodes/window';
 export { ZoneNode } from './nodes/zone';
 export type { AnyNodeId, AnyNodeType } from './types';
 export { AnyNode } from './types';

package/dist/schema/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAE3E,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEvC,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAExF,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzC,YAAY,EACV,eAAe,EACf,KAAK,EACL,UAAU,EACV,OAAO,EACP,MAAM,EACN,WAAW,EACX,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,aAAa,GACd,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC3F,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC1F,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"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"}

package/dist/schema/index.js

@@ -5,24 +5,27 @@ export { CameraSchema } from './camera';
 // Collections
 export { generateCollectionId } from './collections';
 // Material
-export { DEFAULT_MATERIALS, MaterialPreset, MaterialProperties, MaterialSchema, resolveMaterial, } from './material';
+export { DEFAULT_MATERIALS, MaterialMapPropertiesSchema, MaterialMapsSchema, MaterialPreset, MaterialPresetPayloadSchema, MaterialProperties, MaterialSchema, MaterialTarget, resolveMaterial, TextureWrapMode, } from './material';
 export { BuildingNode } from './nodes/building';
 export { CeilingNode } from './nodes/ceiling';
+export { COLUMN_PRESETS, ColumnBaseStyle, ColumnCapitalStyle, ColumnCarvingPlacement, ColumnCrossSection, ColumnNode, ColumnPanelShape, ColumnRingPlacement, ColumnShaftDetail, ColumnShaftProfile, ColumnStyle, } from './nodes/column';
 export { DoorNode, DoorSegment } from './nodes/door';
 export { FenceBaseStyle, FenceNode, FenceStyle } from './nodes/fence';
-export { GuideNode } from './nodes/guide';
-export { getScaledDimensions, ItemNode } from './nodes/item';
+export { GuideNode, GuideScaleReference } from './nodes/guide';
+export { getScaledDimensions, ItemNode, isLowProfileItemSurface, LOW_PROFILE_ITEM_SURFACE_MAX_HEIGHT, } from './nodes/item';
 export { LevelNode } from './nodes/level';
-export { RoofNode } from './nodes/roof';
+export { getEffectiveRoofSurfaceMaterial, RoofNode } from './nodes/roof';
 export { RoofSegmentNode, RoofType } from './nodes/roof-segment';
 export { ScanNode } from './nodes/scan';
 // Nodes
 export { SiteNode } from './nodes/site';
 export { SlabNode } from './nodes/slab';
-export { StairNode, StairRailingMode, StairTopLandingMode, StairType } from './nodes/stair';
+export { SpawnNode } from './nodes/spawn';
+export { getEffectiveStairSurfaceMaterial, StairNode, StairRailingMode, StairSlabOpeningMode, StairTopLandingMode, StairType, } from './nodes/stair';
 export { AttachmentSide, StairSegmentNode, StairSegmentType } from './nodes/stair-segment';
-export { WallNode } from './nodes/wall';
-export { WindowNode } from './nodes/window';
+export { SurfaceHoleMetadata } from './nodes/surface-hole-metadata';
+export { getEffectiveWallSurfaceMaterial, getWallSurfaceMaterialSignature, WallNode, } from './nodes/wall';
+export { WindowNode, WindowType } from './nodes/window';
 export { ZoneNode } from './nodes/zone';
 // Union types
 export { AnyNode } from './types';

package/dist/schema/material.d.ts

@@ -1,6 +1,5 @@
 import { z } from 'zod';
 export declare const MaterialPreset: z.ZodEnum<{
-    custom: "custom";
     white: "white";
     brick: "brick";
     concrete: "concrete";
@@ -10,6 +9,7 @@ export declare const MaterialPreset: z.ZodEnum<{
     plaster: "plaster";
     tile: "tile";
     marble: "marble";
+    custom: "custom";
 }>;
 export type MaterialPreset = z.infer<typeof MaterialPreset>;
 export declare const MaterialProperties: z.ZodObject<{
@@ -26,8 +26,8 @@ export declare const MaterialProperties: z.ZodObject<{
 }, z.core.$strip>;
 export type MaterialProperties = z.infer<typeof MaterialProperties>;
 export declare const MaterialSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
     preset: z.ZodOptional<z.ZodEnum<{
-        custom: "custom";
         white: "white";
         brick: "brick";
         concrete: "concrete";
@@ -37,6 +37,7 @@ export declare const MaterialSchema: z.ZodObject<{
         plaster: "plaster";
         tile: "tile";
         marble: "marble";
+        custom: "custom";
     }>>;
     properties: z.ZodOptional<z.ZodObject<{
         color: z.ZodDefault<z.ZodString>;
@@ -57,6 +58,115 @@ export declare const MaterialSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type MaterialSchema = z.infer<typeof MaterialSchema>;
+export declare const MaterialTarget: z.ZodEnum<{
+    wall: "wall";
+    roof: "roof";
+    "roof-segment": "roof-segment";
+    stair: "stair";
+    "stair-segment": "stair-segment";
+    fence: "fence";
+    column: "column";
+    slab: "slab";
+    ceiling: "ceiling";
+    door: "door";
+    window: "window";
+}>;
+export type MaterialTarget = z.infer<typeof MaterialTarget>;
+export declare const TextureWrapMode: z.ZodEnum<{
+    Repeat: "Repeat";
+    ClampToEdge: "ClampToEdge";
+    MirroredRepeat: "MirroredRepeat";
+}>;
+export type TextureWrapMode = z.infer<typeof TextureWrapMode>;
+export declare const MaterialMapsSchema: z.ZodObject<{
+    albedoMap: z.ZodOptional<z.ZodString>;
+    metalnessMap: z.ZodOptional<z.ZodString>;
+    roughnessMap: z.ZodOptional<z.ZodString>;
+    normalMap: z.ZodOptional<z.ZodString>;
+    displacementMap: z.ZodOptional<z.ZodString>;
+    aoMap: z.ZodOptional<z.ZodString>;
+    emissiveMap: z.ZodOptional<z.ZodString>;
+    bumpMap: z.ZodOptional<z.ZodString>;
+    alphaMap: z.ZodOptional<z.ZodString>;
+    lightMap: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MaterialMaps = z.infer<typeof MaterialMapsSchema>;
+export declare const MaterialMapPropertiesSchema: z.ZodObject<{
+    color: z.ZodDefault<z.ZodString>;
+    roughness: z.ZodDefault<z.ZodNumber>;
+    metalness: z.ZodDefault<z.ZodNumber>;
+    repeatX: z.ZodDefault<z.ZodNumber>;
+    repeatY: z.ZodDefault<z.ZodNumber>;
+    rotation: z.ZodDefault<z.ZodNumber>;
+    wrapS: z.ZodDefault<z.ZodEnum<{
+        Repeat: "Repeat";
+        ClampToEdge: "ClampToEdge";
+        MirroredRepeat: "MirroredRepeat";
+    }>>;
+    wrapT: z.ZodDefault<z.ZodEnum<{
+        Repeat: "Repeat";
+        ClampToEdge: "ClampToEdge";
+        MirroredRepeat: "MirroredRepeat";
+    }>>;
+    normalScaleX: z.ZodDefault<z.ZodNumber>;
+    normalScaleY: z.ZodDefault<z.ZodNumber>;
+    emissiveIntensity: z.ZodDefault<z.ZodNumber>;
+    displacementScale: z.ZodDefault<z.ZodNumber>;
+    transparent: z.ZodDefault<z.ZodBoolean>;
+    flipY: z.ZodDefault<z.ZodBoolean>;
+    bumpScale: z.ZodDefault<z.ZodNumber>;
+    emissiveColor: z.ZodDefault<z.ZodString>;
+    aoMapIntensity: z.ZodDefault<z.ZodNumber>;
+    side: z.ZodDefault<z.ZodNumber>;
+    opacity: z.ZodDefault<z.ZodNumber>;
+    lightMapIntensity: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type MaterialMapProperties = z.infer<typeof MaterialMapPropertiesSchema>;
+export declare const MaterialPresetPayloadSchema: z.ZodObject<{
+    maps: z.ZodObject<{
+        albedoMap: z.ZodOptional<z.ZodString>;
+        metalnessMap: z.ZodOptional<z.ZodString>;
+        roughnessMap: z.ZodOptional<z.ZodString>;
+        normalMap: z.ZodOptional<z.ZodString>;
+        displacementMap: z.ZodOptional<z.ZodString>;
+        aoMap: z.ZodOptional<z.ZodString>;
+        emissiveMap: z.ZodOptional<z.ZodString>;
+        bumpMap: z.ZodOptional<z.ZodString>;
+        alphaMap: z.ZodOptional<z.ZodString>;
+        lightMap: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    mapProperties: z.ZodObject<{
+        color: z.ZodDefault<z.ZodString>;
+        roughness: z.ZodDefault<z.ZodNumber>;
+        metalness: z.ZodDefault<z.ZodNumber>;
+        repeatX: z.ZodDefault<z.ZodNumber>;
+        repeatY: z.ZodDefault<z.ZodNumber>;
+        rotation: z.ZodDefault<z.ZodNumber>;
+        wrapS: z.ZodDefault<z.ZodEnum<{
+            Repeat: "Repeat";
+            ClampToEdge: "ClampToEdge";
+            MirroredRepeat: "MirroredRepeat";
+        }>>;
+        wrapT: z.ZodDefault<z.ZodEnum<{
+            Repeat: "Repeat";
+            ClampToEdge: "ClampToEdge";
+            MirroredRepeat: "MirroredRepeat";
+        }>>;
+        normalScaleX: z.ZodDefault<z.ZodNumber>;
+        normalScaleY: z.ZodDefault<z.ZodNumber>;
+        emissiveIntensity: z.ZodDefault<z.ZodNumber>;
+        displacementScale: z.ZodDefault<z.ZodNumber>;
+        transparent: z.ZodDefault<z.ZodBoolean>;
+        flipY: z.ZodDefault<z.ZodBoolean>;
+        bumpScale: z.ZodDefault<z.ZodNumber>;
+        emissiveColor: z.ZodDefault<z.ZodString>;
+        aoMapIntensity: z.ZodDefault<z.ZodNumber>;
+        side: z.ZodDefault<z.ZodNumber>;
+        opacity: z.ZodDefault<z.ZodNumber>;
+        lightMapIntensity: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type MaterialPresetPayload = z.infer<typeof MaterialPresetPayloadSchema>;
 export declare const DEFAULT_MATERIALS: Record<MaterialPreset, MaterialProperties>;
 export declare function resolveMaterial(material?: MaterialSchema): MaterialProperties;
 //# sourceMappingURL=material.d.ts.map

package/dist/schema/material.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"material.d.ts","sourceRoot":"","sources":["../../src/schema/material.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,cAAc;;;;;;;;;;;EAWzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D,eAAO,MAAM,kBAAkB;;;;;;;;;;;iBAO7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,cAAc,EAAE,kBAAkB,CAiFxE,CAAA;AAED,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,kBAAkB,CAiB7E"}
+{"version":3,"file":"material.d.ts","sourceRoot":"","sources":["../../src/schema/material.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,cAAc;;;;;;;;;;;EAWzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D,eAAO,MAAM,kBAAkB;;;;;;;;;;;iBAO7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D,eAAO,MAAM,cAAc;;;;;;;;;;;;EAYzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D,eAAO,MAAM,eAAe;;;;EAAsD,CAAA;AAClF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D,eAAO,MAAM,kBAAkB;;;;;;;;;;;iBAW7B,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqBtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAE/E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAE/E,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,cAAc,EAAE,kBAAkB,CAiFxE,CAAA;AAED,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,kBAAkB,CAiB7E"}

package/dist/schema/material.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { AssetUrl } from './asset-url';
 export const MaterialPreset = z.enum([
     'white',
     'brick',
@@ -20,16 +21,69 @@ export const MaterialProperties = z.object({
     side: z.enum(['front', 'back', 'double']).default('front'),
 });
 export const MaterialSchema = z.object({
+    id: z.string().optional(),
     preset: MaterialPreset.optional(),
     properties: MaterialProperties.optional(),
     texture: z
         .object({
-        url: z.string(),
+        url: AssetUrl,
         repeat: z.tuple([z.number(), z.number()]).optional(),
         scale: z.number().optional(),
     })
         .optional(),
 });
+export const MaterialTarget = z.enum([
+    'wall',
+    'roof',
+    'roof-segment',
+    'stair',
+    'stair-segment',
+    'fence',
+    'column',
+    'slab',
+    'ceiling',
+    'door',
+    'window',
+]);
+export const TextureWrapMode = z.enum(['Repeat', 'ClampToEdge', 'MirroredRepeat']);
+export const MaterialMapsSchema = z.object({
+    albedoMap: AssetUrl.optional(),
+    metalnessMap: AssetUrl.optional(),
+    roughnessMap: AssetUrl.optional(),
+    normalMap: AssetUrl.optional(),
+    displacementMap: AssetUrl.optional(),
+    aoMap: AssetUrl.optional(),
+    emissiveMap: AssetUrl.optional(),
+    bumpMap: AssetUrl.optional(),
+    alphaMap: AssetUrl.optional(),
+    lightMap: AssetUrl.optional(),
+});
+export const MaterialMapPropertiesSchema = z.object({
+    color: z.string().default('#ffffff'),
+    roughness: z.number().min(0).max(1).default(0.5),
+    metalness: z.number().min(0).max(1).default(0),
+    repeatX: z.number().default(1),
+    repeatY: z.number().default(1),
+    rotation: z.number().default(0),
+    wrapS: TextureWrapMode.default('Repeat'),
+    wrapT: TextureWrapMode.default('Repeat'),
+    normalScaleX: z.number().default(1),
+    normalScaleY: z.number().default(1),
+    emissiveIntensity: z.number().default(1),
+    displacementScale: z.number().default(0.02),
+    transparent: z.boolean().default(false),
+    flipY: z.boolean().default(true),
+    bumpScale: z.number().default(1),
+    emissiveColor: z.string().default('#000000'),
+    aoMapIntensity: z.number().default(1),
+    side: z.number().default(0),
+    opacity: z.number().min(0).max(1).default(1),
+    lightMapIntensity: z.number().default(1),
+});
+export const MaterialPresetPayloadSchema = z.object({
+    maps: MaterialMapsSchema,
+    mapProperties: MaterialMapPropertiesSchema,
+});
 export const DEFAULT_MATERIALS = {
     white: {
         color: '#ffffff',

package/dist/schema/nodes/ceiling.d.ts

@@ -19,8 +19,8 @@ export declare const CeilingNode: z.ZodObject<{
     type: z.ZodDefault<z.ZodLiteral<"ceiling">>;
     children: z.ZodDefault<z.ZodArray<z.ZodDefault<z.ZodTemplateLiteral<`item_${string}`>>>>;
     material: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
         preset: z.ZodOptional<z.ZodEnum<{
-            custom: "custom";
             white: "white";
             brick: "brick";
             concrete: "concrete";
@@ -30,6 +30,7 @@ export declare const CeilingNode: z.ZodObject<{
             plaster: "plaster";
             tile: "tile";
             marble: "marble";
+            custom: "custom";
         }>>;
         properties: z.ZodOptional<z.ZodObject<{
             color: z.ZodDefault<z.ZodString>;
@@ -49,9 +50,18 @@ export declare const CeilingNode: z.ZodObject<{
             scale: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    materialPreset: z.ZodOptional<z.ZodString>;
     polygon: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
     holes: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>>;
+    holeMetadata: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        source: z.ZodDefault<z.ZodEnum<{
+            stair: "stair";
+            manual: "manual";
+        }>>;
+        stairId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     height: z.ZodDefault<z.ZodNumber>;
+    autoFromWalls: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type CeilingNode = z.infer<typeof CeilingNode>;
 //# sourceMappingURL=ceiling.d.ts.map

package/dist/schema/nodes/ceiling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ceiling.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/ceiling.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcvB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA"}
+{"version":3,"file":"ceiling.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/ceiling.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBvB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA"}

package/dist/schema/nodes/ceiling.js

@@ -3,16 +3,22 @@ import { z } from 'zod';
 import { BaseNode, nodeType, objectId } from '../base';
 import { MaterialSchema } from '../material';
 import { ItemNode } from './item';
+import { SurfaceHoleMetadata } from './surface-hole-metadata';
 export const CeilingNode = BaseNode.extend({
     id: objectId('ceiling'),
     type: nodeType('ceiling'),
     children: z.array(ItemNode.shape.id).default([]),
     material: MaterialSchema.optional(),
+    materialPreset: z.string().optional(),
     polygon: z.array(z.tuple([z.number(), z.number()])),
     holes: z.array(z.array(z.tuple([z.number(), z.number()]))).default([]),
+    holeMetadata: z.array(SurfaceHoleMetadata).default([]),
     height: z.number().default(2.5), // Height in meters
+    autoFromWalls: z.boolean().default(false),
 }).describe(dedent `
   Ceiling node - used to represent a ceiling in the building
   - polygon: array of [x, z] points defining the ceiling boundary
   - holes: array of polygons representing holes in the ceiling
+  - holeMetadata: metadata parallel to holes, used to preserve manual and stair-managed cutouts
+  - autoFromWalls: whether the ceiling is automatically generated from a closed wall loop
   `);