@pascal-app/core 0.7.0 → 0.9.1

package/dist/schema/nodes/elevator.js

@@ -0,0 +1,54 @@
+import dedent from 'dedent';
+import { z } from 'zod';
+import { BaseNode, nodeType, objectId } from '../base';
+import { MaterialSchema } from '../material';
+export const ElevatorDoorStyle = z.enum(['center-opening', 'single-left', 'single-right']);
+export const ElevatorDoorPanelStyle = z.enum(['glass-frame', 'solid-panel', 'segmented-panel']);
+export const ElevatorShaftStyle = z.enum(['solid', 'glass']);
+export const ElevatorNode = BaseNode.extend({
+    id: objectId('elevator'),
+    type: nodeType('elevator'),
+    material: MaterialSchema.optional(),
+    materialPreset: z.string().optional(),
+    position: z.tuple([z.number(), z.number(), z.number()]).default([0, 0, 0]),
+    // Rotation around the Y axis in radians.
+    rotation: z.number().default(0),
+    width: z.number().default(1.84),
+    depth: z.number().default(1.84),
+    shaftWidth: z.number().optional(),
+    shaftDepth: z.number().optional(),
+    shaftWallThickness: z.number().default(0.09),
+    shaftStyle: ElevatorShaftStyle.default('solid'),
+    cabHeight: z.number().default(2.35),
+    doorWidth: z.number().default(0.95),
+    doorHeight: z.number().default(2.1),
+    doorStyle: ElevatorDoorStyle.default('center-opening'),
+    doorPanelStyle: ElevatorDoorPanelStyle.default('glass-frame'),
+    fromLevelId: z.string().nullable().default(null),
+    toLevelId: z.string().nullable().default(null),
+    servedLevelIds: z.array(z.string()).optional(),
+    disabledLevelIds: z.array(z.string()).default([]),
+    serviceOnlyLevelIds: z.array(z.string()).default([]),
+    defaultLevelId: z.string().nullable().default(null),
+    speed: z.number().default(2.2),
+    doorDurationMs: z.number().default(900),
+    dwellMs: z.number().default(1400),
+}).describe(dedent `
+  Elevator node - a vertical transport core attached to a building.
+  - parentId: building that owns this elevator
+  - position: building-local shaft center on the X/Z plane
+  - rotation: rotation around the Y axis
+  - width/depth: cab footprint
+  - shaftWidth/shaftDepth: optional clear shaft footprint; falls back to cab footprint
+  - shaftWallThickness: visible shaft shell thickness
+  - shaftStyle: solid or glass shaft shell presentation
+  - cabHeight: visible elevator cab height
+  - doorWidth/doorHeight/doorStyle: landing and cab door movement/opening presentation
+  - doorPanelStyle: visual leaf style for glass-frame, solid-panel, or segmented-panel doors
+  - fromLevelId / toLevelId: source and destination levels used for service range and auto cutouts
+  - servedLevelIds: legacy optional explicit level list; used only when from/to are missing
+  - disabledLevelIds: stops visible in the service range but unavailable for public/cab requests
+  - serviceOnlyLevelIds: stops unavailable from landing calls but available from cab/admin controls
+  - defaultLevelId: starting/resting level, falling back to the lowest served level
+  - speed/doorDurationMs/dwellMs: runtime animation defaults
+  `);

package/dist/schema/nodes/eyebrow-vent.d.ts

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+export declare const EyebrowVentNode: z.ZodObject<{
+    object: z.ZodDefault<z.ZodLiteral<"node">>;
+    name: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    visible: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    camera: z.ZodOptional<z.ZodObject<{
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        target: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        mode: z.ZodDefault<z.ZodEnum<{
+            perspective: "perspective";
+            orthographic: "orthographic";
+        }>>;
+        fov: z.ZodOptional<z.ZodNumber>;
+        zoom: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodJSONSchema>>;
+    id: z.ZodDefault<z.ZodTemplateLiteral<`eyebrow-vent_${string}`>>;
+    type: z.ZodDefault<z.ZodLiteral<"eyebrow-vent">>;
+    material: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        preset: z.ZodOptional<z.ZodEnum<{
+            custom: "custom";
+            white: "white";
+            brick: "brick";
+            concrete: "concrete";
+            wood: "wood";
+            glass: "glass";
+            metal: "metal";
+            plaster: "plaster";
+            tile: "tile";
+            marble: "marble";
+        }>>;
+        properties: z.ZodOptional<z.ZodObject<{
+            color: z.ZodDefault<z.ZodString>;
+            roughness: z.ZodDefault<z.ZodNumber>;
+            metalness: z.ZodDefault<z.ZodNumber>;
+            opacity: z.ZodDefault<z.ZodNumber>;
+            transparent: z.ZodDefault<z.ZodBoolean>;
+            side: z.ZodDefault<z.ZodEnum<{
+                front: "front";
+                back: "back";
+                double: "double";
+            }>>;
+        }, z.core.$strip>>;
+        texture: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            repeat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            scale: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    materialPreset: z.ZodDefault<z.ZodString>;
+    roofSegmentId: z.ZodOptional<z.ZodString>;
+    position: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    rotation: z.ZodDefault<z.ZodNumber>;
+    width: z.ZodDefault<z.ZodNumber>;
+    depth: z.ZodDefault<z.ZodNumber>;
+    height: z.ZodDefault<z.ZodNumber>;
+    style: z.ZodDefault<z.ZodEnum<{
+        scoop: "scoop";
+        "half-round": "half-round";
+        "slant-box": "slant-box";
+    }>>;
+    louverCount: z.ZodDefault<z.ZodNumber>;
+    backRatio: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type EyebrowVentNode = z.infer<typeof EyebrowVentNode>;
+//# sourceMappingURL=eyebrow-vent.d.ts.map

package/dist/schema/nodes/eyebrow-vent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eyebrow-vent.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/eyebrow-vent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2C3B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA"}

package/dist/schema/nodes/eyebrow-vent.js

@@ -0,0 +1,40 @@
+import dedent from 'dedent';
+import { z } from 'zod';
+import { BaseNode, nodeType, objectId } from '../base';
+import { MaterialSchema } from '../material';
+export const EyebrowVentNode = BaseNode.extend({
+    id: objectId('eyebrow-vent'),
+    type: nodeType('eyebrow-vent'),
+    material: MaterialSchema.optional(),
+    // Default to the white preset so a freshly-placed vent reads as clean
+    // painted metal and the paint inspector shows "White" (matches box-vent).
+    materialPreset: z.string().default('preset-white'),
+    roofSegmentId: z.string().optional(),
+    position: z.tuple([z.number(), z.number(), z.number()]).default([0, 0, 0]),
+    rotation: z.number().default(0),
+    // `width` is the opening width (left↔right across the louvered face),
+    // `depth` the front-to-back projection along the roof, `height` the rise.
+    width: z.number().default(0.5),
+    depth: z.number().default(0.6),
+    height: z.number().default(0.3),
+    // Body shape:
+    //  - `scoop`      : rounded louvered opening that sweeps back and tapers
+    //                   into the flashing plate (the classic dormer "eyebrow").
+    //  - `half-round` : a D-shaped half-round louver vent (flat louvered face,
+    //                   semicircular curved top, short body).
+    //  - `slant-box`  : a low box with a slanted top and a screened front.
+    style: z.enum(['scoop', 'half-round', 'slant-box']).default('scoop'),
+    // Number of horizontal louver slats across the front opening (0 = open /
+    // screened only).
+    louverCount: z.number().int().min(0).max(8).default(3),
+    // `slant-box` only: the low rear edge as a fraction of the tall front edge.
+    // 1 = flat-topped box, lower = the top slopes down more steeply toward the
+    // back.
+    backRatio: z.number().min(0.15).max(1).default(0.5),
+}).describe(dedent `
+  Eyebrow vent — a low roof ventilator with a rounded, louvered front that
+  sits on a flashing plate. Three styles: a swept "scoop" eyebrow, a D-shaped
+  "half-round" louver vent, and a "slant-box" hood. Parented to a roof-segment;
+  position is segment-local. Rotation is around the segment's vertical axis
+  (post-slope tilt).
+  `);

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

@@ -29,6 +29,7 @@ export declare const FenceNode: z.ZodObject<{
     material: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         preset: z.ZodOptional<z.ZodEnum<{
+            custom: "custom";
             white: "white";
             brick: "brick";
             concrete: "concrete";
@@ -38,7 +39,6 @@ export declare const FenceNode: z.ZodObject<{
             plaster: "plaster";
             tile: "tile";
             marble: "marble";
-            custom: "custom";
         }>>;
         properties: z.ZodOptional<z.ZodObject<{
             color: z.ZodDefault<z.ZodString>;
@@ -61,9 +61,9 @@ export declare const FenceNode: z.ZodObject<{
     materialPreset: z.ZodOptional<z.ZodString>;
     start: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     end: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
-    curveOffset: z.ZodOptional<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     thickness: z.ZodDefault<z.ZodNumber>;
+    curveOffset: z.ZodOptional<z.ZodNumber>;
     baseHeight: z.ZodDefault<z.ZodNumber>;
     postSpacing: z.ZodDefault<z.ZodNumber>;
     postSize: z.ZodDefault<z.ZodNumber>;
@@ -74,6 +74,7 @@ export declare const FenceNode: z.ZodObject<{
         floating: "floating";
         grounded: "grounded";
     }>>;
+    showInfill: z.ZodDefault<z.ZodBoolean>;
     color: z.ZodDefault<z.ZodString>;
     style: z.ZodDefault<z.ZodEnum<{
         slat: "slat";

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

@@ -1 +1 @@
-{"version":3,"file":"fence.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/fence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,UAAU;;;;EAAsC,CAAA;AAC7D,eAAO,MAAM,cAAc;;;EAAmC,CAAA;AAE9D,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BrB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA"}
+{"version":3,"file":"fence.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/fence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,UAAU;;;;EAAsC,CAAA;AAC7D,eAAO,MAAM,cAAc;;;EAAmC,CAAA;AAE9D,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+BrB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA"}

package/dist/schema/nodes/fence.js

@@ -11,9 +11,9 @@ export const FenceNode = BaseNode.extend({
     materialPreset: z.string().optional(),
     start: z.tuple([z.number(), z.number()]),
     end: z.tuple([z.number(), z.number()]),
-    curveOffset: z.number().optional(),
     height: z.number().default(1.8),
     thickness: z.number().default(0.08),
+    curveOffset: z.number().optional(),
     baseHeight: z.number().default(0.22),
     postSpacing: z.number().default(2),
     postSize: z.number().default(0.1),
@@ -21,14 +21,16 @@ export const FenceNode = BaseNode.extend({
     groundClearance: z.number().default(0),
     edgeInset: z.number().default(0.015),
     baseStyle: FenceBaseStyle.default('grounded'),
+    showInfill: z.boolean().default(true),
     color: z.string().default('#ffffff'),
     style: FenceStyle.default('slat'),
 }).describe(dedent `
   Fence node - used to represent a fence segment in the building/site level coordinate system
   - start/end: fence endpoints in level coordinate system
-  - curveOffset: midpoint sagitta offset used to bend the fence into an arc
   - height/thickness: overall fence dimensions in meters
+  - curveOffset: midpoint sagitta offset used to bend the fence into an arc
   - baseHeight/postSpacing/postSize/topRailHeight: exact geometric controls from the plan3D fence model
   - groundClearance/edgeInset/baseStyle: fence support and inset configuration
+  - showInfill: whether to draw intermediate posts/slats between end posts
   - color/style: visual appearance options
   `);

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

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+export declare const GutterOutlet: z.ZodObject<{
+    id: z.ZodString;
+    offset: z.ZodDefault<z.ZodNumber>;
+    diameter: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type GutterOutlet = z.infer<typeof GutterOutlet>;
+export declare const GutterNode: z.ZodObject<{
+    object: z.ZodDefault<z.ZodLiteral<"node">>;
+    name: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    visible: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    camera: z.ZodOptional<z.ZodObject<{
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        target: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        mode: z.ZodDefault<z.ZodEnum<{
+            perspective: "perspective";
+            orthographic: "orthographic";
+        }>>;
+        fov: z.ZodOptional<z.ZodNumber>;
+        zoom: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodJSONSchema>>;
+    id: z.ZodDefault<z.ZodTemplateLiteral<`gutter_${string}`>>;
+    type: z.ZodDefault<z.ZodLiteral<"gutter">>;
+    material: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        preset: z.ZodOptional<z.ZodEnum<{
+            custom: "custom";
+            white: "white";
+            brick: "brick";
+            concrete: "concrete";
+            wood: "wood";
+            glass: "glass";
+            metal: "metal";
+            plaster: "plaster";
+            tile: "tile";
+            marble: "marble";
+        }>>;
+        properties: z.ZodOptional<z.ZodObject<{
+            color: z.ZodDefault<z.ZodString>;
+            roughness: z.ZodDefault<z.ZodNumber>;
+            metalness: z.ZodDefault<z.ZodNumber>;
+            opacity: z.ZodDefault<z.ZodNumber>;
+            transparent: z.ZodDefault<z.ZodBoolean>;
+            side: z.ZodDefault<z.ZodEnum<{
+                front: "front";
+                back: "back";
+                double: "double";
+            }>>;
+        }, z.core.$strip>>;
+        texture: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            repeat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            scale: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    materialPreset: z.ZodDefault<z.ZodString>;
+    roofSegmentId: z.ZodOptional<z.ZodString>;
+    position: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    rotation: z.ZodDefault<z.ZodNumber>;
+    length: z.ZodDefault<z.ZodNumber>;
+    size: z.ZodDefault<z.ZodNumber>;
+    thickness: z.ZodDefault<z.ZodNumber>;
+    profile: z.ZodDefault<z.ZodEnum<{
+        box: "box";
+        "half-round": "half-round";
+        "k-style": "k-style";
+    }>>;
+    endCapLeft: z.ZodDefault<z.ZodBoolean>;
+    endCapRight: z.ZodDefault<z.ZodBoolean>;
+    hangerStyle: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        strap: "strap";
+    }>>;
+    hangerSpacing: z.ZodDefault<z.ZodNumber>;
+    outlets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        offset: z.ZodDefault<z.ZodNumber>;
+        diameter: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type GutterNode = z.infer<typeof GutterNode>;
+//# sourceMappingURL=gutter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gutter.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/gutter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,eAAO,MAAM,YAAY;;;;iBAUvB,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEvD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkEtB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA"}

package/dist/schema/nodes/gutter.js

@@ -0,0 +1,76 @@
+import dedent from 'dedent';
+import { z } from 'zod';
+import { BaseNode, nodeType, objectId } from '../base';
+import { MaterialSchema } from '../material';
+// A single drop outlet drilled in the gutter floor. A gutter can carry
+// several so a long run can split between multiple downspouts (each
+// downspout links to one outlet via its `outletId`).
+export const GutterOutlet = z.object({
+    // Stable id the downspout references. Generated with `generateId('outlet')`.
+    id: z.string(),
+    // Position along the gutter length (gutter-local +X), signed from the
+    // CENTER. The geometry clamps it inside the end caps at build time, so
+    // a stored value that no longer fits just rides the nearest bound.
+    offset: z.number().default(0),
+    // Bore diameter of this drop. Default 0.07 m ≈ 3″. The cross-section
+    // SHAPE (round vs rectangular) follows the gutter's profile, not this.
+    diameter: z.number().default(0.07),
+});
+export const GutterNode = BaseNode.extend({
+    id: objectId('gutter'),
+    type: nodeType('gutter'),
+    material: MaterialSchema.optional(),
+    // White preset by default — matches the rest of the roof accessory
+    // family (box-vent / ridge-vent) so the paint inspector reads as
+    // "White" instead of "no material" on a freshly-placed gutter.
+    materialPreset: z.string().default('preset-white'),
+    roofSegmentId: z.string().optional(),
+    // Segment-local. The placement tool snaps to the eave line (Z =
+    // +depth/2, Y = wallHeight) of the segment under the cursor; X is
+    // wherever the user clicked. After placement the inspector + length
+    // handles can shift X along the eave.
+    position: z.tuple([z.number(), z.number(), z.number()]).default([0, 0, 0]),
+    // Rotation around the gutter's own local Y. Kept at 0 by default
+    // because the gutter's length axis is constrained to the eave
+    // direction (segment-local +X) — but exposed in case the user wants
+    // to tilt for a custom run.
+    rotation: z.number().default(0),
+    // Length along the eave (gutter-local +X).
+    length: z.number().default(2.0),
+    // Profile size — the vertical drop of the U-channel below the eave
+    // line. 5″ (0.127 m) is the most common residential gutter size; 6″
+    // (0.152 m) is the common commercial / heavy-duty size. Default
+    // rounds the residential value to 0.13 m.
+    size: z.number().default(0.13),
+    // Wall thickness of the U-channel. Visible on the rim from above; too
+    // thin reads as a paper strip, too thick reads as a curb.
+    thickness: z.number().default(0.006),
+    profile: z.enum(['k-style', 'half-round', 'box']).default('k-style'),
+    // End caps close the open ends of the U-channel so water can't run
+    // out the sides. Independent per-end because a downspout typically
+    // joins the gutter at one end while the other stays capped. Default
+    // true on both — matches a freshly-installed residential gutter.
+    endCapLeft: z.boolean().default(true),
+    endCapRight: z.boolean().default(true),
+    // Hangers are the metal straps that hold the gutter onto the
+    // fascia. 'strap' renders periodic bars across the rim; 'none'
+    // hides them (some plastic gutters use hidden clips). Spacing is
+    // metres between hanger centers; real residential code is roughly
+    // 0.6 m for snow-load areas, 0.75 m elsewhere.
+    hangerStyle: z.enum(['strap', 'none']).default('strap'),
+    hangerSpacing: z.number().default(0.6),
+    // Downspout outlets — short drop tubes descending from the gutter
+    // floor where downspouts connect. Empty by default so existing
+    // gutters don't sprout outlets on schema upgrade. Each is drilled
+    // through the trough floor via CSG; a downspout links to one by id.
+    outlets: z.array(GutterOutlet).default([]),
+}).describe(dedent `
+  Gutter — a rain-water channel running along the eave of a roof
+  segment. Parented to a roof-segment; position is segment-local.
+  - length: span along the eave (gutter-local +X)
+  - size:   profile drop below the eave line (vertical extent)
+  - profile: k-style (ogee fascia), half-round, or square box
+  - endCapLeft / endCapRight: close the trough at gutter-local -X / +X
+  - hangerStyle / hangerSpacing: visible metal straps across the rim
+  - outlets: drop-tube outlets (id + along-length offset + bore diameter)
+  `);

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

@@ -144,6 +144,12 @@ declare const assetSchema: z.ZodObject<{
     name: z.ZodString;
     thumbnail: z.ZodString;
     floorPlanUrl: z.ZodOptional<z.ZodString>;
+    source: z.ZodDefault<z.ZodEnum<{
+        library: "library";
+        community: "community";
+        mine: "mine";
+    }>>;
+    isDraft: z.ZodOptional<z.ZodBoolean>;
     src: z.ZodString;
     dimensions: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
     attachTo: z.ZodOptional<z.ZodEnum<{
@@ -151,7 +157,9 @@ declare const assetSchema: z.ZodObject<{
         ceiling: "ceiling";
         "wall-side": "wall-side";
     }>>;
+    recessed: z.ZodOptional<z.ZodBoolean>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    functionTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     offset: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
     rotation: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
     scale: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
@@ -240,6 +248,12 @@ export declare const ItemNode: z.ZodObject<{
         name: z.ZodString;
         thumbnail: z.ZodString;
         floorPlanUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodDefault<z.ZodEnum<{
+            library: "library";
+            community: "community";
+            mine: "mine";
+        }>>;
+        isDraft: z.ZodOptional<z.ZodBoolean>;
         src: z.ZodString;
         dimensions: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
         attachTo: z.ZodOptional<z.ZodEnum<{
@@ -247,7 +261,9 @@ export declare const ItemNode: z.ZodObject<{
             ceiling: "ceiling";
             "wall-side": "wall-side";
         }>>;
+        recessed: z.ZodOptional<z.ZodBoolean>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        functionTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         offset: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
         rotation: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
         scale: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;

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

@@ -1 +1 @@
-{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/item.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,QAAA,MAAM,mBAAmB;;;;iBAIvB,CAAA;AAEF,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;iBASvB,CAAA;AAEF,QAAA,MAAM,wBAAwB;;;;;;;;;;iBAO5B,CAAA;AAEF,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAIjB,CAAA;AAIF,QAAA,MAAM,qBAAqB;;;;;;;iBAOzB,CAAA;AAEF,QAAA,MAAM,iBAAiB;;;;;;iBAMrB,CAAA;AAEF,QAAA,MAAM,YAAY;;;;;;;;;;;;;2BAA2E,CAAA;AAI7F,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGrB,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AACzE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AACnD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACnE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAC3D,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AACjD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsBf,CAAA;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AACpD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAE/C,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BnB,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAA;AAE/C,eAAO,MAAM,mCAAmC,MAAM,CAAA;AAEtD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAM/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAI5E"}
+{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/item.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,QAAA,MAAM,mBAAmB;;;;iBAIvB,CAAA;AAEF,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;iBASvB,CAAA;AAEF,QAAA,MAAM,wBAAwB;;;;;;;;;;iBAO5B,CAAA;AAEF,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAIjB,CAAA;AAIF,QAAA,MAAM,qBAAqB;;;;;;;iBAOzB,CAAA;AAEF,QAAA,MAAM,iBAAiB;;;;;;iBAMrB,CAAA;AAEF,QAAA,MAAM,YAAY;;;;;;;;;;;;;2BAA2E,CAAA;AAI7F,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGrB,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AACzE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AACnD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACnE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAC3D,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AACjD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2Cf,CAAA;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AACpD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAE/C,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BnB,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAA;AAE/C,eAAO,MAAM,mCAAmC,MAAM,CAAA;AAEtD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAM/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAI5E"}

package/dist/schema/nodes/item.js

@@ -61,10 +61,31 @@ const assetSchema = z.object({
     // Optional top-down 2D image shown inside the item's footprint on the
     // floor plan. When present, replaces the default diagonal-cross marker.
     floorPlanUrl: z.string().optional(),
+    // Where the item came from in the catalog. Used by the editor's items
+    // panel to filter Library / Community / Mine. The server populates it
+    // from `items.userId`: null → 'library', current user → 'mine',
+    // other user → 'community'. Defaults to 'library' when absent (e.g.
+    // the seeded built-in catalog).
+    source: z.enum(['library', 'community', 'mine']).default('library'),
+    // True when the item belongs to the caller and is still in draft status.
+    // The catalog only loads my drafts (other users' drafts are never
+    // published to the catalog). Used so the Community filter can include
+    // *my* published items alongside other users', while leaving drafts
+    // visible only under Mine.
+    isDraft: z.boolean().optional(),
     src: AssetUrl,
     dimensions: z.tuple([z.number(), z.number(), z.number()]).default([1, 1, 1]), // [w, h, d]
     attachTo: z.enum(['wall', 'wall-side', 'ceiling']).optional(),
+    // Ceiling fixtures (e.g. recessed downlights) that embed *into* the ceiling
+    // rather than hang below it: the item seats flush with the ceiling plane
+    // (its body rising into the void above) and the ceiling is cut out around
+    // the item's footprint. Ignored unless `attachTo === 'ceiling'`.
+    recessed: z.boolean().optional(),
     tags: z.array(z.string()).optional(),
+    // Function-axis tag slugs from the taxonomy. Drives the hierarchical
+    // Items-tab browse: a tree node matches when any of its descendant slugs
+    // appears here. Absent for the seeded built-in catalog.
+    functionTags: z.array(z.string()).optional(),
     // These are "Corrective" transforms to normalize the GLB
     offset: z.tuple([z.number(), z.number(), z.number()]).default([0, 0, 0]),
     rotation: z.tuple([z.number(), z.number(), z.number()]).default([0, 0, 0]),

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

@@ -17,7 +17,7 @@ export declare const LevelNode: z.ZodObject<{
     metadata: z.ZodDefault<z.ZodOptional<z.ZodJSONSchema>>;
     id: z.ZodDefault<z.ZodTemplateLiteral<`level_${string}`>>;
     type: z.ZodDefault<z.ZodLiteral<"level">>;
-    children: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodDefault<z.ZodTemplateLiteral<`wall_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`fence_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`column_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`item_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`zone_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`slab_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`ceiling_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`roof_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`stair_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`scan_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`guide_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`spawn_${string}`>>]>>>;
+    children: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodDefault<z.ZodTemplateLiteral<`wall_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`fence_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`column_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`item_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`zone_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`slab_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`ceiling_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`roof_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`stair_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`scan_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`guide_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`spawn_${string}`>>, z.ZodDefault<z.ZodTemplateLiteral<`shelf_${string}`>>]>>>;
     level: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type LevelNode = z.infer<typeof LevelNode>;

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

@@ -1 +1 @@
-{"version":3,"file":"level.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/level.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAevB,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;iBA6BrB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA"}
+{"version":3,"file":"level.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/level.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAgBvB,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;iBA8BrB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA"}

package/dist/schema/nodes/level.js

@@ -8,6 +8,7 @@ import { GuideNode } from './guide';
 import { ItemNode } from './item';
 import { RoofNode } from './roof';
 import { ScanNode } from './scan';
+import { ShelfNode } from './shelf';
 import { SlabNode } from './slab';
 import { SpawnNode } from './spawn';
 import { StairNode } from './stair';
@@ -30,6 +31,7 @@ export const LevelNode = BaseNode.extend({
         ScanNode.shape.id,
         GuideNode.shape.id,
         SpawnNode.shape.id,
+        ShelfNode.shape.id,
     ]))
         .default([]),
     // Specific props

package/dist/schema/nodes/ridge-vent.d.ts

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+export declare const RidgeVentNode: z.ZodObject<{
+    object: z.ZodDefault<z.ZodLiteral<"node">>;
+    name: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    visible: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    camera: z.ZodOptional<z.ZodObject<{
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        target: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        mode: z.ZodDefault<z.ZodEnum<{
+            perspective: "perspective";
+            orthographic: "orthographic";
+        }>>;
+        fov: z.ZodOptional<z.ZodNumber>;
+        zoom: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodJSONSchema>>;
+    id: z.ZodDefault<z.ZodTemplateLiteral<`rvent_${string}`>>;
+    type: z.ZodDefault<z.ZodLiteral<"ridge-vent">>;
+    material: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        preset: z.ZodOptional<z.ZodEnum<{
+            custom: "custom";
+            white: "white";
+            brick: "brick";
+            concrete: "concrete";
+            wood: "wood";
+            glass: "glass";
+            metal: "metal";
+            plaster: "plaster";
+            tile: "tile";
+            marble: "marble";
+        }>>;
+        properties: z.ZodOptional<z.ZodObject<{
+            color: z.ZodDefault<z.ZodString>;
+            roughness: z.ZodDefault<z.ZodNumber>;
+            metalness: z.ZodDefault<z.ZodNumber>;
+            opacity: z.ZodDefault<z.ZodNumber>;
+            transparent: z.ZodDefault<z.ZodBoolean>;
+            side: z.ZodDefault<z.ZodEnum<{
+                front: "front";
+                back: "back";
+                double: "double";
+            }>>;
+        }, z.core.$strip>>;
+        texture: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            repeat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            scale: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    materialPreset: z.ZodDefault<z.ZodString>;
+    roofSegmentId: z.ZodOptional<z.ZodString>;
+    position: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    rotation: z.ZodDefault<z.ZodNumber>;
+    length: z.ZodDefault<z.ZodNumber>;
+    width: z.ZodDefault<z.ZodNumber>;
+    height: z.ZodDefault<z.ZodNumber>;
+    style: z.ZodDefault<z.ZodEnum<{
+        metal: "metal";
+        standard: "standard";
+        shingled: "shingled";
+    }>>;
+    endCaps: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type RidgeVentNode = z.infer<typeof RidgeVentNode>;
+//# sourceMappingURL=ridge-vent.d.ts.map

package/dist/schema/nodes/ridge-vent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ridge-vent.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/ridge-vent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+BzB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA"}

package/dist/schema/nodes/ridge-vent.js

@@ -0,0 +1,30 @@
+import dedent from 'dedent';
+import { z } from 'zod';
+import { BaseNode, nodeType, objectId } from '../base';
+import { MaterialSchema } from '../material';
+export const RidgeVentNode = BaseNode.extend({
+    id: objectId('rvent'),
+    type: nodeType('ridge-vent'),
+    material: MaterialSchema.optional(),
+    // See note on box-vent: default to white so the paint inspector
+    // reflects the current visual state instead of "no material".
+    materialPreset: z.string().default('preset-white'),
+    roofSegmentId: z.string().optional(),
+    position: z.tuple([z.number(), z.number(), z.number()]).default([0, 0, 0]),
+    rotation: z.number().default(0),
+    length: z.number().default(2.0),
+    width: z.number().default(0.3),
+    // Taller default than the old paper-thin shell so the solid body reads
+    // with real presence on the ridge; still adjustable down to 0.03.
+    height: z.number().default(0.1),
+    style: z.enum(['standard', 'shingled', 'metal']).default('standard'),
+    endCaps: z.boolean().default(true),
+}).describe(dedent `
+  Ridge vent — a ventilation strip that sits along the ridge (peak) of a
+  roof segment. Parented to a roof-segment; position is segment-local.
+  - length: extent along the ridge
+  - width: vent width straddling the ridge center
+  - height: profile height above the ridge surface
+  - style: standard (curved cap) / shingled / metal
+  - endCaps: cap both ends or leave open
+  `);