@3driseai/3drise-core 1.0.17 → 1.0.19

package/dist/utils/settingsPatch.d.ts

@@ -0,0 +1,15 @@
+export type SettingsPatch = Record<string, any>;
+export declare function isPlainObject(value: unknown): value is Record<string, any>;
+/** `base` with `patch` laid over it. Returns `base` itself when the patch is empty. */
+export declare function applySettingsPatch<T>(base: T, patch: SettingsPatch | undefined | null): T;
+/** Several patches composed into one, later ones winning. */
+export declare function composeSettingsPatches(patches: SettingsPatch[]): SettingsPatch | undefined;
+/**
+ * The patch that turns `base` into `next`: every leaf of `next` that differs from
+ * `base`. Keys `next` dropped are ignored — a patch sets values, it does not delete.
+ * `exclude` applies to top-level keys only (identity and behaviour fields).
+ */
+export declare function diffSettings(base: unknown, next: unknown, exclude?: ReadonlySet<string>): SettingsPatch;
+/** Number of leaf values a patch sets (for UI summaries). */
+export declare function countPatchLeaves(patch: SettingsPatch | undefined | null): number;
+//# sourceMappingURL=settingsPatch.d.ts.map

package/dist/utils/settingsPatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settingsPatch.d.ts","sourceRoot":"","sources":["../../src/utils/settingsPatch.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEhD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAI1E;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,GAAG,CAAC,CAUzF;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,aAAa,GAAG,SAAS,CAG1F;AAYD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,WAAW,CAAC,MAAM,CAAa,GAAG,aAAa,CAiBlH;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAKhF"}

package/dist/utils/settingsPatch.js

@@ -0,0 +1,91 @@
+// =============================================================================
+// settingsPatch — deep partials over a settings object
+// =============================================================================
+//
+// A *patch* is a deep partial of a scene element's settings: the same shape as the
+// settings themselves, holding only what differs. Actions store one per target and
+// SceneActions layers them over the authored settings at runtime (never persisted
+// into the settings, never written to Redux).
+//
+// Rules, kept deliberately small:
+//   - plain objects merge key by key, recursively;
+//   - everything else (numbers, strings, booleans, arrays, null) replaces;
+//   - untouched branches keep their identity, so renderers that memoise per block
+//     (CloudsGenerator's deck / cirrus / quality, material application keyed on
+//     materialSettings) only redo the block a patch actually changed.
+//
+export function isPlainObject(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+/** `base` with `patch` laid over it. Returns `base` itself when the patch is empty. */
+export function applySettingsPatch(base, patch) {
+    if (!patch || Object.keys(patch).length === 0)
+        return base;
+    if (!isPlainObject(base))
+        return (isPlainObject(patch) ? { ...patch } : patch);
+    const out = { ...base };
+    for (const key of Object.keys(patch)) {
+        const next = patch[key];
+        const prev = out[key];
+        out[key] = isPlainObject(next) && isPlainObject(prev) ? applySettingsPatch(prev, next) : next;
+    }
+    return out;
+}
+/** Several patches composed into one, later ones winning. */
+export function composeSettingsPatches(patches) {
+    if (patches.length === 0)
+        return undefined;
+    return patches.reduce((acc, p) => applySettingsPatch(acc, p), {});
+}
+function valuesEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null)
+        return false;
+    try {
+        return JSON.stringify(a) === JSON.stringify(b);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The patch that turns `base` into `next`: every leaf of `next` that differs from
+ * `base`. Keys `next` dropped are ignored — a patch sets values, it does not delete.
+ * `exclude` applies to top-level keys only (identity and behaviour fields).
+ */
+export function diffSettings(base, next, exclude = new Set()) {
+    const out = {};
+    if (!isPlainObject(next))
+        return out;
+    const b = isPlainObject(base) ? base : {};
+    for (const key of Object.keys(next)) {
+        if (exclude.has(key))
+            continue;
+        const nv = next[key];
+        const bv = b[key];
+        if (nv === undefined || valuesEqual(nv, bv))
+            continue;
+        if (isPlainObject(nv) && isPlainObject(bv)) {
+            const sub = diffSettings(bv, nv);
+            if (Object.keys(sub).length > 0)
+                out[key] = sub;
+        }
+        else {
+            out[key] = nv;
+        }
+    }
+    return out;
+}
+/** Number of leaf values a patch sets (for UI summaries). */
+export function countPatchLeaves(patch) {
+    if (!patch)
+        return 0;
+    let n = 0;
+    for (const v of Object.values(patch))
+        n += isPlainObject(v) ? countPatchLeaves(v) : 1;
+    return n;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@3driseai/3drise-core",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",