@pascal-app/viewer 1.0.3 → 1.0.5

package/dist/lib/pointer-events.js

@@ -21,11 +21,12 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  *
- * Vendored from R3F 9.6.1:
- * https://raw.githubusercontent.com/pmndrs/react-three-fiber/v9.6.1/packages/fiber/src/core/events.ts
+ * Vendored from R3F 9.8.2:
+ * https://raw.githubusercontent.com/pmndrs/react-three-fiber/v9.8.2/packages/fiber/src/core/events.ts
  * Ray collection is cached; camera-drag moves are throttled before stock dispatch.
  * The throttle is a vendored-manager policy; dev ?stockEvents uses untouched R3F.
  */
+import { sceneRegistry, useScene } from '@pascal-app/core';
 import { events as createWebEvents, getRootState, } from '@react-three/fiber';
 import * as THREE from 'three';
 import { acceleratedRaycast } from 'three-mesh-bvh';
@@ -61,10 +62,10 @@ function isSupportedRaycast(raycast) {
         supportedRaycasts.has(raycast) ||
         raycast[pureRaycast] === true);
 }
-export function choosePointerEvents(search = typeof window !== 'undefined' ? window.location.search : '') {
+export function choosePointerEvents(search = typeof window !== 'undefined' ? window.location.search : '', onBreadcrumb) {
     return process.env.NODE_ENV !== 'production' && new URLSearchParams(search).has('stockEvents')
         ? createWebEvents
-        : createPascalPointerEvents;
+        : (store) => createPascalPointerEvents(store, onBreadcrumb);
 }
 function querySnapshot(raycaster) {
     if (Object.getPrototypeOf(raycaster) !== THREE.Raycaster.prototype ||
@@ -112,10 +113,92 @@ function querySnapshot(raycaster) {
     }
     return snapshot;
 }
+/**
+ * Whether a mesh has a material for everything a raycast reads: three indexes
+ * a material array by each geometry group, and one with no entry throws on
+ * `material.side`. A mesh caught mid-swap (a preview restored an older array
+ * over a rebuilt geometry) is skipped for this move instead of taking the whole
+ * pointer event down; its children are still tested. `material` asks the same of
+ * an array the mesh would wear.
+ */
+export function hasMaterialsForGroups(object, material = object.material) {
+    const mesh = object;
+    if (!mesh.isMesh)
+        return true;
+    if (!material)
+        return false;
+    if (!Array.isArray(material))
+        return true;
+    for (const group of mesh.geometry?.groups ?? []) {
+        if (!material[group.materialIndex ?? 0])
+            return false;
+    }
+    return true;
+}
 function distanceOrder(a, b) {
     return a.distance - b.distance;
 }
-function createCachedRaycast() {
+/** The scene node `object` draws for: itself or its nearest registered ancestor. */
+function owningNode(object) {
+    const owners = new Map();
+    for (const [id, registered] of sceneRegistry.nodes)
+        owners.set(registered, id);
+    for (let at = object; at; at = at.parent) {
+        const id = owners.get(at);
+        if (id === undefined)
+            continue;
+        const node = useScene.getState().nodes[id];
+        return { id, type: node?.type ?? null };
+    }
+    return null;
+}
+/**
+ * Reports each mesh a pointer raycast skips for groups with no material, once
+ * per material it wears: pointer moves would otherwise repeat it every frame.
+ */
+function createInvalidMaterialReporter(onBreadcrumb) {
+    const reported = new WeakMap();
+    return (object) => {
+        const material = object.material;
+        if (!onBreadcrumb || (reported.has(object) && reported.get(object) === material))
+            return;
+        reported.set(object, material);
+        const node = owningNode(object);
+        onBreadcrumb({
+            category: 'raycast_invalid_material',
+            message: 'Pointer raycast skipped a mesh whose geometry groups have no material',
+            level: 'warning',
+            data: { nodeType: node?.type ?? null, nodeId: node?.id ?? null, objectName: object.name },
+        });
+    };
+}
+/**
+ * Three's recursive `intersectObject`, skipping meshes `hasMaterialsForGroups`
+ * rejects. A raycaster with its own `intersectObject` is asked directly.
+ */
+export function intersectDrawable(raycaster, object, skip) {
+    if (raycaster.intersectObject !== stockIntersectObject) {
+        return raycaster.intersectObject(object, true);
+    }
+    const hits = [];
+    const visit = (current) => {
+        let result;
+        if (current.layers.test(raycaster.layers)) {
+            if (hasMaterialsForGroups(current))
+                result = current.raycast(raycaster, hits);
+            else
+                skip(current);
+        }
+        if (result === false)
+            return;
+        const children = current.children;
+        for (let i = 0, length = children.length; i < length; i++)
+            visit(children[i]);
+    };
+    visit(object);
+    return hits.sort(distanceOrder);
+}
+function createCachedRaycast(skip) {
     const queries = new WeakMap();
     const activeQueries = [];
     const rootHits = [];
@@ -140,7 +223,10 @@ function createCachedRaycast() {
                 unsupportedObject = object;
                 return false;
             }
-            result = object.raycast(raycaster, hits);
+            if (hasMaterialsForGroups(object))
+                result = object.raycast(raycaster, hits);
+            else
+                skip(object);
         }
         if (result !== false) {
             const children = object.children;
@@ -223,9 +309,9 @@ function createCachedRaycast() {
         },
     };
 }
-export function createPascalPointerEvents(store) {
+export function createPascalPointerEvents(store, onBreadcrumb) {
     const manager = createWebEvents(store);
-    const { handlePointer } = createEvents(store);
+    const { handlePointer } = createEvents(store, onBreadcrumb);
     for (const name of Object.keys(manager.handlers)) {
         manager.handlers[name] = handlePointer(name);
     }
@@ -246,7 +332,7 @@ export function createPascalPointerEvents(store) {
     return manager;
 }
 function makeId(event) {
-    // biome-ignore lint/style/useTemplate: Keep the vendored dispatch identical to R3F 9.6.1.
+    // biome-ignore lint/style/useTemplate: Keep the vendored dispatch identical to R3F 9.8.2.
     return (event.eventObject || event.object).uuid + '/' + event.index + event.instanceId;
 }
 /**
@@ -264,7 +350,8 @@ function releaseInternalPointerCapture(capturedMap, obj, captures, pointerId) {
         }
     }
 }
-function createEvents(store) {
+function createEvents(store, onBreadcrumb) {
+    const skipInvalidMaterial = createInvalidMaterialReporter(onBreadcrumb);
     const stats = {
         events: 0,
         cachedEvents: 0,
@@ -320,7 +407,7 @@ function createEvents(store) {
             // Make sure root-level pointer and ray are set up
             state.events.compute?.(event, state);
         }
-        collectors[collectionDepth] ??= createCachedRaycast();
+        collectors[collectionDepth] ??= createCachedRaycast(skipInvalidMaterial);
         const collector = collectors[collectionDepth++];
         let hits = [];
         let stock = false;
@@ -342,7 +429,7 @@ function createEvents(store) {
                 }
                 if (layer.raycaster.camera) {
                     const rootHits = stock
-                        ? layer.raycaster.intersectObject(obj, true)
+                        ? intersectDrawable(layer.raycaster, obj, skipInvalidMaterial)
                         : collector.intersectObject(obj, layer);
                     if (!rootHits) {
                         const unsupported = collector.unsupportedObject;

package/dist/lib/post-processing-resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-processing-resources.d.ts","sourceRoot":"","sources":["../../src/lib/post-processing-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAIlD,qBAAa,uBAAuB;IAClC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAO;IACxC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAK;IAChC,OAAO,EAAE;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,GAAG,IAAI,CAAO;IAC1C,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAO;IAEtC,OAAO;CAUR"}
+{"version":3,"file":"post-processing-resources.d.ts","sourceRoot":"","sources":["../../src/lib/post-processing-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAIlD,qBAAa,uBAAuB;IAClC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAO;IACxC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAK;IAChC,OAAO,EAAE;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,GAAG,IAAI,CAAO;IAC1C,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAO;IAEtC,OAAO,SASN;CACF"}

package/dist/lib/procedural-emission.d.ts

@@ -0,0 +1,7 @@
+import type { EvaluatedLight } from '@pascal-app/core/procedural-items';
+import type { Material, Mesh, Object3D } from 'three';
+export declare function cloneWithProceduralEmission(material: Material, color: string, on: boolean): Material;
+export declare function setProceduralEmission(material: Material, on: boolean): void;
+export declare function proceduralSlotMeshes(root: Object3D, slots: Set<string>): Mesh[];
+export declare function decorateProceduralEmission(root: Object3D, lights: EvaluatedLight[], on: boolean): () => void;
+//# sourceMappingURL=procedural-emission.d.ts.map

package/dist/lib/procedural-emission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedural-emission.d.ts","sourceRoot":"","sources":["../../src/lib/procedural-emission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AACvE,OAAO,KAAK,EAAS,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAQ5D,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,OAAO,GACV,QAAQ,CAQV;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAG3E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAW/E;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,cAAc,EAAE,EACxB,EAAE,EAAE,OAAO,GACV,MAAM,IAAI,CAwBZ"}

package/dist/lib/procedural-emission.js

@@ -0,0 +1,54 @@
+export function cloneWithProceduralEmission(material, color, on) {
+    const clone = material.clone();
+    clone.userData = { ...clone.userData, __pascalCachedMaterial: false };
+    if (clone.emissive)
+        clone.emissive.set(color);
+    if ('emissiveIntensity' in clone)
+        clone.emissiveIntensity = on ? 1 : 0;
+    if ('emissiveMap' in clone)
+        clone.emissiveMap = null;
+    clone.needsUpdate = true;
+    return clone;
+}
+export function setProceduralEmission(material, on) {
+    const controlled = material;
+    if ('emissiveIntensity' in controlled)
+        controlled.emissiveIntensity = on ? 1 : 0;
+}
+export function proceduralSlotMeshes(root, slots) {
+    const meshes = [];
+    const owner = root.userData.pascalId;
+    const visit = (object) => {
+        if (object !== root && object.userData.pascalId && object.userData.pascalId !== owner)
+            return;
+        const mesh = object;
+        if (mesh.isMesh && slots.has(mesh.userData.slotId))
+            meshes.push(mesh);
+        for (const child of object.children)
+            visit(child);
+    };
+    visit(root);
+    return meshes;
+}
+export function decorateProceduralEmission(root, lights, on) {
+    const colors = new Map(lights.flatMap((light) => light.emissiveSlot ? [[light.emissiveSlot, light.color]] : []));
+    const restores = [];
+    for (const mesh of proceduralSlotMeshes(root, new Set(colors.keys()))) {
+        const slot = mesh.userData.slotId;
+        const color = colors.get(slot);
+        if (!color)
+            continue;
+        const previous = mesh.material;
+        const clones = (Array.isArray(previous) ? previous : [previous]).map((material) => cloneWithProceduralEmission(material, color, on));
+        mesh.material = Array.isArray(previous) ? clones : clones[0];
+        restores.push(() => {
+            mesh.material = previous;
+            for (const clone of clones)
+                clone.dispose();
+        });
+    }
+    return () => {
+        for (const restore of restores)
+            restore();
+    };
+}

package/dist/lib/reveal-candidates.d.ts

@@ -0,0 +1,80 @@
+import { type AnyNode, type AnyNodeId, type RevealStyle, type SceneCommit } from '@pascal-app/core';
+import type { RevealCandidate } from './reveal-schedule';
+import type { PlayedStyle } from './reveal-wipe';
+/**
+ * How much of the construction plays. `off` shows a build at once; `simple`
+ * keeps the scattered order with only `rise` and `scale`; `full` adds the
+ * falls, settles, cuts, assembled roofs and the dust. `framing` plays the
+ * same motions on the lazy, nested schedule (floor by floor, room by room,
+ * piece by piece; `planLazyReveal`), overdone a little, and plugins that stage
+ * their own members (the framing) read it and play them in the prerolls.
+ */
+export type ConstructionRevealLevel = 'off' | 'simple' | 'full' | 'framing';
+/** A candidate; for an assembled node's part, also the node it assembles. */
+export type StagedCandidate = RevealCandidate & {
+    host?: string;
+};
+/** A roof piece lifts this share of its drop before it falls: a hair, 20 cm of 4 m. */
+export declare const PART_LEAD = 0.05;
+/** `simple` keeps the stagger with only the two slice-one motions. */
+export declare function styleAt(style: RevealStyle, at: ConstructionRevealLevel): PlayedStyle;
+/** Kinds that hold the others: staging one would unmount everything under it. */
+export declare const CONTAINERS: ReadonlySet<string>;
+/**
+ * What `commit` stages at `at`: each node it creates whose kind declares a
+ * reveal, and the new parts (children declaring none) of each one that
+ * assembles. A new node of a kind that declares none comes in with a default
+ * reveal when what holds it was already there (under a new host, it comes in
+ * with the host). `seq` counts on from `firstSeq` in arrival order. Each
+ * candidate carries its room and its place in it (`layoutRevealCandidates`).
+ */
+export declare function commitRevealCandidates({ before, current, author }: SceneCommit, at: ConstructionRevealLevel, firstSeq?: number): StagedCandidate[];
+/**
+ * Gives each candidate its room for the lazy schedule: the room it stands in (a node on a line, the
+ * room on either side of its middle), else, for a node on a line, a run of the lines it meets end to
+ * end (`capabilities.revealLayout`); its room's
+ * sweep across the floor; and its place in the room (around the room's centre, or along the run).
+ * What stands in no room keeps none: it belongs to the floor.
+ */
+export declare function layoutRevealCandidates(candidates: StagedCandidate[], nodes: Record<AnyNodeId, AnyNode>): void;
+/** Where a piece stood in its level: its position, and its turn about the vertical. */
+export type Placement = {
+    position: [number, number, number];
+    yaw: number;
+};
+/**
+ * A piece changed by a commit. `from` is where a moved piece stood when it can glide from there, else
+ * null; `edited` marks a piece whose picture was edited (a wall bent, a slab resized), which plays its
+ * reveal again, quickly (`commitEditCandidates`).
+ */
+export type ChangeCandidate = StagedCandidate & {
+    from: Placement | null;
+    edited?: true;
+};
+/**
+ * What `commit` moves: each piece of furniture it finds already there that is placed differently
+ * (another position, turn or parent). Furniture only, for now: walls and openings move with the
+ * rooms and walls that hold them.
+ */
+export declare function commitChangeCandidates({ before, current, author }: SceneCommit, at: ConstructionRevealLevel, firstSeq?: number): ChangeCandidate[];
+/**
+ * What taking `ids` back reveals: each of them, and everything under them (a wall's openings, a
+ * room's furniture), as the build would have staged it: by what its kind declares, or the default
+ * reveal a kind that declares none came in with. What stands in a host that goes (a segment of a
+ * stair, a part of a pool) goes with it; an assembled node (a roof) goes whole, not part by part.
+ */
+export declare function nodeRevealCandidates(ids: Iterable<string>, nodes: Record<AnyNodeId, AnyNode>, at: ConstructionRevealLevel): RevealCandidate[];
+/**
+ * What `commit` edits: each node already there whose kind lists `capabilities.revealOnEdit` and one of
+ * those fields (the ones that make its picture) changed. A change to any other field stays instant, and
+ * so does what the structure reconciler derived from an edit (`derivedWrites`: the plates and ceilings it
+ * owns, the fields it wrote on a node): a wall moved does not make its room's floor rise again.
+ */
+export declare function commitEditCandidates({ before, current, author, derivedWrites }: SceneCommit, at: ConstructionRevealLevel, firstSeq?: number): ChangeCandidate[];
+/**
+ * What `commit` deletes that the picture can play out: each node that was there and is gone whose kind
+ * stages a reveal, as it was staged when built (a node standing in a host that goes with it goes with
+ * its host). Derived construction the reconciler retires is not a deletion the person or the agent made.
+ */
+export declare function commitDeleteCandidates({ before, current, author, derivedWrites }: SceneCommit, at: ConstructionRevealLevel, firstSeq?: number): StagedCandidate[];
+//# sourceMappingURL=reveal-candidates.d.ts.map

package/dist/lib/reveal-candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reveal-candidates.d.ts","sourceRoot":"","sources":["../../src/lib/reveal-candidates.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,SAAS,EAMd,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAA;AAE3E,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjE,uFAAuF;AACvF,eAAO,MAAM,SAAS,OAAO,CAAA;AAE7B,sEAAsE;AACtE,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,uBAAuB,GAAG,WAAW,CAKpF;AAED,iFAAiF;AACjF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,MAAM,CAA0C,CAAA;AAiFrF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EACxC,EAAE,EAAE,uBAAuB,EAC3B,QAAQ,SAAI,GACX,eAAe,EAAE,CA0CnB;AA2FD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,eAAe,EAAE,EAC7B,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAChC,IAAI,CAqEN;AAoED,uFAAuF;AACvF,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3E;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG;IAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,IAAI,CAAA;CAAE,CAAA;AAmCzF;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EACxC,EAAE,EAAE,uBAAuB,EAC3B,QAAQ,SAAI,GACX,eAAe,EAAE,CAoBnB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EACrB,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACjC,EAAE,EAAE,uBAAuB,GAC1B,eAAe,EAAE,CAsBnB;AAgBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,WAAW,EACvD,EAAE,EAAE,uBAAuB,EAC3B,QAAQ,SAAI,GACX,eAAe,EAAE,CA4BnB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,WAAW,EACvD,EAAE,EAAE,uBAAuB,EAC3B,QAAQ,SAAI,GACX,eAAe,EAAE,CA4BnB"}