@pascal-app/core 1.0.3 → 1.0.5

package/dist/procedural-items/library-colors.d.ts

@@ -4,40 +4,40 @@ import type { Recipe } from './recipe.js';
 type ProceduralFinish = NonNullable<Recipe['slots'][number]['finish']>;
 export declare const FINISH_LIBRARY_REFS: {
     readonly glass: readonly [{
-        readonly ref: "library:preset-glass";
-        readonly color: "#87ceeb";
+        readonly ref: 'library:preset-glass';
+        readonly color: '#87ceeb';
     }];
     readonly metal: readonly [{
-        readonly ref: "library:metal-steel";
-        readonly color: "#636363";
+        readonly ref: 'library:metal-steel';
+        readonly color: '#636363';
     }, {
-        readonly ref: "library:metal-chrome";
-        readonly color: "#c8ccce";
+        readonly ref: 'library:metal-chrome';
+        readonly color: '#c8ccce';
     }, {
-        readonly ref: "library:metal-brass";
-        readonly color: "#b08d57";
+        readonly ref: 'library:metal-brass';
+        readonly color: '#b08d57';
     }, {
-        readonly ref: "library:metal-copper";
-        readonly color: "#cc845b";
+        readonly ref: 'library:metal-copper';
+        readonly color: '#cc845b';
     }, {
-        readonly ref: "library:metal-polished";
-        readonly color: "#f3f3f3";
+        readonly ref: 'library:metal-polished';
+        readonly color: '#f3f3f3';
     }, {
-        readonly ref: "library:preset-metal";
-        readonly color: "#c7ccd2";
+        readonly ref: 'library:preset-metal';
+        readonly color: '#c7ccd2';
     }];
     readonly wood: readonly [{
-        readonly ref: "library:wood-finewood27";
-        readonly color: "#a77440";
+        readonly ref: 'library:wood-finewood27';
+        readonly color: '#a77440';
     }, {
-        readonly ref: "library:wood-woodplank48";
-        readonly color: "#88654c";
+        readonly ref: 'library:wood-woodplank48';
+        readonly color: '#88654c';
     }, {
-        readonly ref: "library:wood-hungarianparquet2";
-        readonly color: "#663020";
+        readonly ref: 'library:wood-hungarianparquet2';
+        readonly color: '#663020';
     }, {
-        readonly ref: "library:wood-squareparquet21";
-        readonly color: "#3e220d";
+        readonly ref: 'library:wood-squareparquet21';
+        readonly color: '#3e220d';
     }];
 };
 export declare function proceduralFinishLibraryColor(ref: string): string | undefined;
@@ -49,6 +49,18 @@ export type LibraryColorMatch = {
     distance: number;
 };
 export declare function nearestLibraryColorRef(hex: string, catalog?: readonly MaterialCatalogItem[]): LibraryColorMatch | null;
+export type PascalMaterialHints = {
+    name?: string;
+    color?: string;
+    roughness?: number;
+    metalness?: number;
+    /** See-through: transmissive, or alpha-blended below the viewer's glass opacity. */
+    transparent?: boolean;
+    emissive?: boolean;
+    finish?: ProceduralFinish | 'color';
+};
+/** Deterministic finish/tone matching; uncertain colours keep their authored material. */
+export declare function matchPascalMaterial(slot: PascalMaterialHints): `library:${string}` | null;
 export declare function snapProceduralSlotsToLibrary(node: ProceduralItemNode, options?: {
     keepOverrides: true;
 }): ProceduralItemNode['slots'];

package/dist/procedural-items/library-colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library-colors.d.ts","sourceRoot":"","sources":["../../src/procedural-items/library-colors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC,KAAK,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;AAItE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmB/B,CAAA;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI5E;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,GACZ,WAAW,MAAM,EAAE,GAAG,SAAS,CAGjC;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,WAAW,MAAM,EAAE,CAAA;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAiCD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,SAAS,mBAAmB,EAAqB,GACzD,iBAAiB,GAAG,IAAI,CAc1B;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE;IAAE,aAAa,EAAE,IAAI,CAAA;CAA4B,GACzD,kBAAkB,CAAC,OAAO,CAAC,CAU7B"}
+{"version":3,"file":"library-colors.d.ts","sourceRoot":"","sources":["../../src/procedural-items/library-colors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC,KAAK,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;AAItE,eAAO,MAAM,mBAAmB;;sBACf,sBAAsB;wBAAS,SAAS;;;sBAE9C,qBAAqB;wBAAS,SAAS;;sBACvC,sBAAsB;wBAAS,SAAS;;sBACxC,qBAAqB;wBAAS,SAAS;;sBACvC,sBAAsB;wBAAS,SAAS;;sBACxC,wBAAwB;wBAAS,SAAS;;sBAC1C,sBAAsB;wBAAS,SAAS;;;sBAGxC,yBAAyB;wBAAS,SAAS;;sBAC3C,0BAA0B;wBAAS,SAAS;;sBAC5C,gCAAgC;wBAAS,SAAS;;sBAClD,8BAA8B;wBAAS,SAAS;;CAK1D,CAAA;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI5E;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,GACZ,WAAW,MAAM,EAAE,GAAG,SAAS,CAGjC;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,WAAW,MAAM,EAAE,CAAA;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAiCD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,SAAS,mBAAmB,EAAqB,GACzD,iBAAiB,GAAG,IAAI,CAc1B;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oFAAoF;IACpF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAA;CACpC,CAAA;AAED,0FAA0F;AAC1F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,MAAM,EAAE,GAAG,IAAI,CAqCzF;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE;IAAE,aAAa,EAAE,IAAI,CAAA;CAA4B,GACzD,kBAAkB,CAAC,OAAO,CAAC,CAQ7B"}

package/dist/procedural-items/library-colors.js

@@ -69,14 +69,48 @@ export function nearestLibraryColorRef(hex, catalog = MATERIAL_CATALOG) {
         name: entry.label,
     })));
 }
+/** Deterministic finish/tone matching; uncertain colours keep their authored material. */
+export function matchPascalMaterial(slot) {
+    if (slot.emissive)
+        return null;
+    const name = (slot.name ?? '').replace(/([a-z])([A-Z])/g, '$1 $2').replace(/[_-]/g, ' ');
+    const finish = slot.finish ??
+        (slot.transparent || /\b(glass|glazing|glazed|transparent)\b/i.test(name)
+            ? 'glass'
+            : (slot.metalness ?? 0) >= 0.5 ||
+                /\b(metal|metallic|steel|stainless|chrome|brass|copper|bronze|aluminum|aluminium|iron)\b/i.test(name)
+                ? 'metal'
+                : /\b(wood|wooden|timber|lumber|oak|walnut|pine|cedar|cherry|teak|mahogany|maple|birch|beech|bamboo|plywood)\b/i.test(name)
+                    ? 'wood'
+                    : undefined);
+    if (finish === 'glass')
+        return 'library:preset-glass';
+    if (finish && finish !== 'color') {
+        return resolveProceduralFinishRef(finish, slot.color ?? '') ?? null;
+    }
+    if (!slot.color)
+        return null;
+    if (finish !== 'color') {
+        const wood = nearestColor(slot.color, FINISH_LIBRARY_REFS.wood);
+        // Colour alone only implies wood near a curated brown tone, on a non-glossy dielectric.
+        if (wood &&
+            wood.distance <= 8 &&
+            (slot.metalness ?? 0) < 0.2 &&
+            (slot.roughness ?? 1) >= 0.4 &&
+            !/\b(fabric|leather|plastic|rubber|paint|ceramic)\b/i.test(name))
+            return wood.ref;
+        if ((slot.metalness ?? 0) >= 0.2 || (slot.roughness ?? 1) < 0.4)
+            return null;
+    }
+    const color = nearestLibraryColorRef(slot.color);
+    return color && (finish === 'color' || color.distance <= 6) ? color.ref : null;
+}
 export function snapProceduralSlotsToLibrary(node, options = { keepOverrides: true }) {
     const slots = { ...node.slots };
     for (const slot of node.recipe.slots) {
         if (options.keepOverrides && Object.hasOwn(node.slots, slot.id))
             continue;
-        const ref = slot.finish
-            ? resolveProceduralFinishRef(slot.finish, slot.color)
-            : nearestLibraryColorRef(slot.color)?.ref;
+        const ref = matchPascalMaterial({ finish: slot.finish ?? 'color', color: slot.color });
         if (ref)
             slots[slot.id] = ref;
     }

package/dist/procedural-items/motion-controller.d.ts

@@ -0,0 +1,29 @@
+import { type EvaluatedMotion, motionTimeline } from './recipe.js';
+export type MotionCommand = {
+    sequence: number;
+    scope: 'all' | {
+        partId: string;
+    };
+    target: boolean;
+};
+export declare class ProceduralMotionController {
+    readonly motions: readonly EvaluatedMotion[];
+    readonly timeline: ReturnType<typeof motionTimeline>;
+    private collective;
+    private parts;
+    private spins;
+    private targets;
+    private sequence;
+    constructor(motions: readonly EvaluatedMotion[], initial?: Record<string, boolean>);
+    command(command: MotionCommand): void;
+    tick(dt: number): {
+        times: Record<string, number>;
+        fractions: Record<string, number>;
+        spins: Record<string, {
+            phase: number;
+            speed: number;
+        }>;
+        pending: boolean;
+    };
+}
+//# sourceMappingURL=motion-controller.d.ts.map

package/dist/procedural-items/motion-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-controller.d.ts","sourceRoot":"","sources":["../../src/procedural-items/motion-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAsB,cAAc,EAAE,MAAM,UAAU,CAAA;AAEnF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACjC,MAAM,EAAE,OAAO,CAAA;CAChB,CAAA;AAID,qBAAa,0BAA0B;IASnC,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE;IAR9C,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;IACpD,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,KAAK,CAAsD;IACnE,OAAO,CAAC,OAAO,CAA+C;IAC9D,OAAO,CAAC,QAAQ,CAAK;IAErB,YACW,OAAO,EAAE,SAAS,eAAe,EAAE,EAC5C,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAQtC;IAED,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CA4DpC;IAED,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG;QAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC7B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QACvD,OAAO,EAAE,OAAO,CAAA;KACjB,CAoDA;CACF"}

package/dist/procedural-items/motion-controller.js

@@ -0,0 +1,130 @@
+import { finitePoseFraction, motionTimeline } from './recipe.js';
+export class ProceduralMotionController {
+    motions;
+    timeline;
+    collective = null;
+    parts = new Map();
+    spins = new Map();
+    targets = Object.create(null);
+    sequence = -1;
+    constructor(motions, initial = {}) {
+        this.motions = motions;
+        this.timeline = motionTimeline({ motions: [...motions] });
+        for (const [partId, { A, B }] of Object.entries(this.timeline.perPart))
+            this.parts.set(partId, { time: initial[partId] ? B : A, lower: A, upper: B, direction: 0 });
+        for (const motion of motions)
+            if (motion.kind === 'spin')
+                this.spins.set(motion.id, { phase: 0, speed: 0 });
+        this.targets = { ...initial };
+    }
+    command(command) {
+        if (command.sequence <= this.sequence)
+            return;
+        this.sequence = command.sequence;
+        if (command.scope === 'all') {
+            for (const partId of this.parts.keys())
+                this.targets[partId] = command.target;
+            for (const motion of this.motions)
+                if (motion.kind === 'spin')
+                    this.targets[motion.partId] = command.target;
+            if (this.collective) {
+                this.collective.direction = command.target ? 1 : -1;
+            }
+            else {
+                const entries = [...this.parts.entries()];
+                const atStart = entries.every(([, cursor]) => cursor.time === cursor.lower);
+                const atEnd = entries.every(([, cursor]) => cursor.time === cursor.upper);
+                if (atStart || atEnd) {
+                    const time = atEnd ? this.timeline.T : 0;
+                    this.collective = {
+                        time,
+                        lower: 0,
+                        upper: this.timeline.T,
+                        direction: command.target ? 1 : -1,
+                    };
+                    this.parts.clear();
+                }
+                else {
+                    for (const [partId, cursor] of this.parts) {
+                        const { A, B } = this.timeline.perPart[partId];
+                        cursor.time = Math.max(A, Math.min(B, cursor.time));
+                        cursor.lower = A;
+                        cursor.upper = B;
+                        cursor.direction = command.target ? 1 : -1;
+                    }
+                }
+            }
+            return;
+        }
+        const partId = command.scope.partId;
+        this.targets[partId] = command.target;
+        if (this.collective) {
+            const shared = this.collective;
+            for (const [id, { A, B }] of Object.entries(this.timeline.perPart))
+                this.parts.set(id, id === partId
+                    ? {
+                        time: Math.max(A, Math.min(B, shared.time)),
+                        lower: A,
+                        upper: B,
+                        direction: command.target ? 1 : -1,
+                    }
+                    : { time: shared.time, lower: 0, upper: this.timeline.T, direction: shared.direction });
+            this.collective = null;
+        }
+        const cursor = this.parts.get(partId);
+        if (cursor) {
+            const { A, B } = this.timeline.perPart[partId];
+            cursor.time = Math.max(A, Math.min(B, cursor.time));
+            cursor.lower = A;
+            cursor.upper = B;
+            cursor.direction = command.target ? 1 : -1;
+        }
+    }
+    tick(dt) {
+        const step = Math.max(0, dt);
+        if (this.collective) {
+            const cursor = this.collective;
+            cursor.time = Math.max(cursor.lower, Math.min(cursor.upper, cursor.time + cursor.direction * step));
+            if (cursor.time === (cursor.direction > 0 ? cursor.upper : cursor.lower)) {
+                for (const [partId, { A, B }] of Object.entries(this.timeline.perPart))
+                    this.parts.set(partId, {
+                        time: cursor.direction > 0 ? B : A,
+                        lower: A,
+                        upper: B,
+                        direction: 0,
+                    });
+                this.collective = null;
+            }
+        }
+        if (!this.collective) {
+            for (const cursor of this.parts.values()) {
+                cursor.time = Math.max(cursor.lower, Math.min(cursor.upper, cursor.time + cursor.direction * step));
+                if (cursor.time === (cursor.direction > 0 ? cursor.upper : cursor.lower))
+                    cursor.direction = 0;
+            }
+        }
+        const times = Object.create(null);
+        for (const partId of Object.keys(this.timeline.perPart))
+            times[partId] = this.collective?.time ?? this.parts.get(partId)?.time ?? 0;
+        const fractions = Object.create(null);
+        for (const motion of this.motions)
+            if (motion.kind !== 'spin')
+                fractions[motion.id] = finitePoseFraction(motion, times[motion.partId] ?? 0);
+        let pending = Boolean(this.collective) || [...this.parts.values()].some((cursor) => cursor.direction !== 0);
+        for (const motion of this.motions) {
+            if (motion.kind !== 'spin')
+                continue;
+            const state = this.spins.get(motion.id);
+            const target = this.targets[motion.partId] ? 1 : 0;
+            const sign = Math.sign(target - state.speed);
+            const rampTime = Math.min(step, Math.abs(target - state.speed) * 0.35);
+            const travel = state.speed * rampTime + (sign * rampTime * rampTime) / 0.7 + target * (step - rampTime);
+            const next = Math.max(0, Math.min(1, state.speed + (sign * rampTime) / 0.35));
+            state.phase = (state.phase + motion.amount * travel) % (2 * Math.PI);
+            state.speed = next;
+            if (next !== target || next > 0)
+                pending = true;
+        }
+        return { times, fractions, spins: Object.fromEntries(this.spins), pending };
+    }
+}