@unseenco/theatre-core 0.1.16 → 0.1.17

package/dist/index.d.ts

@@ -306,6 +306,7 @@ type ShorthandCompoundPropsToLonghandCompoundProps<P extends UnknownShorthandCom
  * ```
  *
  */
+declare function compoundFromSanitizedProps<Props extends UnknownValidCompoundProps>(sanitizedProps: Props, opts?: CommonOpts): PropTypeConfig_Compound<Props>;
 declare const compound: <Props extends UnknownShorthandCompoundProps>(props: Props, opts?: CommonOpts) => PropTypeConfig_Compound<ShorthandCompoundPropsToLonghandCompoundProps<Props>>;
 /**
  * A file prop type
@@ -629,6 +630,7 @@ type PropTypeConfig_AllSimples = PropTypeConfig_Number | PropTypeConfig_Boolean
 type PropTypeConfig = PropTypeConfig_AllSimples | PropTypeConfig_Compound<$IntentionalAny> | PropTypeConfig_Enum;
 
 type index_d_UnknownShorthandCompoundProps = UnknownShorthandCompoundProps;
+declare const index_d_compoundFromSanitizedProps: typeof compoundFromSanitizedProps;
 declare const index_d_compound: typeof compound;
 declare const index_d_file: typeof file;
 declare const index_d_image: typeof image;
@@ -654,6 +656,7 @@ type index_d_PropTypeConfig = PropTypeConfig;
 declare namespace index_d {
   export {
     index_d_UnknownShorthandCompoundProps as UnknownShorthandCompoundProps,
+    index_d_compoundFromSanitizedProps as compoundFromSanitizedProps,
     index_d_compound as compound,
     index_d_file as file,
     index_d_image as image,
@@ -913,6 +916,21 @@ interface ISheetObject<Props extends UnknownShorthandCompoundProps = UnknownShor
         transient?: readonly TransientPropPath[];
         static?: readonly StaticPropPath[];
     }): void;
+    /**
+     * Add new props to this object's config. Existing props are preserved; only
+     * the keys in `config` are added. Throws if a key already exists on the object.
+     *
+     * @example
+     * ```ts
+     * const obj = sheet.object('Box', {x: 0})
+     * obj.addProps({y: 0})
+     * // obj now has props x and y
+     * ```
+     */
+    addProps(config: UnknownShorthandCompoundProps, opts?: {
+        transient?: readonly TransientPropPath[];
+        static?: readonly StaticPropPath[];
+    }): void;
 }
 
 type KeyframeId = Nominal<'KeyframeId'>;

package/dist/index.js

@@ -117,6 +117,51 @@ var require_UnitBezier = __commonJS({
   }
 });
 
+// ../node_modules/fast-deep-equal/index.js
+var require_fast_deep_equal = __commonJS({
+  "../node_modules/fast-deep-equal/index.js"(exports2, module2) {
+    "use strict";
+    module2.exports = function equal(a2, b2) {
+      if (a2 === b2)
+        return true;
+      if (a2 && b2 && typeof a2 == "object" && typeof b2 == "object") {
+        if (a2.constructor !== b2.constructor)
+          return false;
+        var length, i2, keys2;
+        if (Array.isArray(a2)) {
+          length = a2.length;
+          if (length != b2.length)
+            return false;
+          for (i2 = length; i2-- !== 0; )
+            if (!equal(a2[i2], b2[i2]))
+              return false;
+          return true;
+        }
+        if (a2.constructor === RegExp)
+          return a2.source === b2.source && a2.flags === b2.flags;
+        if (a2.valueOf !== Object.prototype.valueOf)
+          return a2.valueOf() === b2.valueOf();
+        if (a2.toString !== Object.prototype.toString)
+          return a2.toString() === b2.toString();
+        keys2 = Object.keys(a2);
+        length = keys2.length;
+        if (length !== Object.keys(b2).length)
+          return false;
+        for (i2 = length; i2-- !== 0; )
+          if (!Object.prototype.hasOwnProperty.call(b2, keys2[i2]))
+            return false;
+        for (i2 = length; i2-- !== 0; ) {
+          var key = keys2[i2];
+          if (!equal(a2[key], b2[key]))
+            return false;
+        }
+        return true;
+      }
+      return a2 !== a2 && b2 !== b2;
+    };
+  }
+});
+
 // ../node_modules/levenshtein-edit-distance/index.js
 var require_levenshtein_edit_distance = __commonJS({
   "../node_modules/levenshtein-edit-distance/index.js"(exports2, module2) {
@@ -206,51 +251,6 @@ var require_propose = __commonJS({
   }
 });
 
-// ../node_modules/fast-deep-equal/index.js
-var require_fast_deep_equal = __commonJS({
-  "../node_modules/fast-deep-equal/index.js"(exports2, module2) {
-    "use strict";
-    module2.exports = function equal(a2, b2) {
-      if (a2 === b2)
-        return true;
-      if (a2 && b2 && typeof a2 == "object" && typeof b2 == "object") {
-        if (a2.constructor !== b2.constructor)
-          return false;
-        var length, i2, keys2;
-        if (Array.isArray(a2)) {
-          length = a2.length;
-          if (length != b2.length)
-            return false;
-          for (i2 = length; i2-- !== 0; )
-            if (!equal(a2[i2], b2[i2]))
-              return false;
-          return true;
-        }
-        if (a2.constructor === RegExp)
-          return a2.source === b2.source && a2.flags === b2.flags;
-        if (a2.valueOf !== Object.prototype.valueOf)
-          return a2.valueOf() === b2.valueOf();
-        if (a2.toString !== Object.prototype.toString)
-          return a2.toString() === b2.toString();
-        keys2 = Object.keys(a2);
-        length = keys2.length;
-        if (length !== Object.keys(b2).length)
-          return false;
-        for (i2 = length; i2-- !== 0; )
-          if (!Object.prototype.hasOwnProperty.call(b2, keys2[i2]))
-            return false;
-        for (i2 = length; i2-- !== 0; ) {
-          var key = keys2[i2];
-          if (!equal(a2[key], b2[key]))
-            return false;
-        }
-        return true;
-      }
-      return a2 !== a2 && b2 !== b2;
-    };
-  }
-});
-
 // core/src/index.ts
 var src_exports = {};
 __export(src_exports, {
@@ -1208,6 +1208,7 @@ var propTypes_exports = {};
 __export(propTypes_exports, {
   boolean: () => boolean,
   compound: () => compound,
+  compoundFromSanitizedProps: () => compoundFromSanitizedProps,
   file: () => file,
   image: () => image,
   number: () => number,
@@ -3289,9 +3290,8 @@ var validateCommonOpts = (fnCallSignature, opts) => {
     }
   }
 };
-var compound = (props, opts = {}) => {
+function compoundFromSanitizedProps(sanitizedProps, opts = {}) {
   validateCommonOpts("t.compound(props, opts)", opts);
-  const sanitizedProps = sanitizeCompoundProps(props);
   const deserializationCache = /* @__PURE__ */ new WeakMap();
   const config = {
     type: "compound",
@@ -3326,6 +3326,10 @@ var compound = (props, opts = {}) => {
     }
   };
   return config;
+}
+var compound = (props, opts = {}) => {
+  const sanitizedProps = sanitizeCompoundProps(props);
+  return compoundFromSanitizedProps(sanitizedProps, opts);
 };
 var file = (defaultValue, opts = {}) => {
   if (process.env.NODE_ENV !== "production") {
@@ -3677,6 +3681,21 @@ function resolveShowPropsOfSources(host, objects, apiName) {
   });
 }
 
+// core/src/sheetObjects/unsanitizedObjectProps.ts
+var weakMapOfUnsanitizedProps = /* @__PURE__ */ new WeakMap();
+function getUnsanitizedObjectProps(object) {
+  return weakMapOfUnsanitizedProps.get(object);
+}
+function setUnsanitizedObjectProps(object, config) {
+  weakMapOfUnsanitizedProps.set(object, config);
+}
+function mergeUnsanitizedObjectProps(object, additional) {
+  const existing = weakMapOfUnsanitizedProps.get(object) ?? {};
+  const merged = { ...existing, ...additional };
+  weakMapOfUnsanitizedProps.set(object, merged);
+  return merged;
+}
+
 // core/src/sheetObjects/TheatreSheetObject.ts
 var KEEP_HOT_FOR_MS = 5 * 1e3;
 var TheatreSheetObject = class {
@@ -3781,8 +3800,25 @@ var TheatreSheetObject = class {
       host.template.setStaticPropPaths(opts.static, sanitizedConfig);
     }
   }
+  addProps(config, opts) {
+    const host = privateAPI(this);
+    host.template.addProps(config);
+    if (process.env.NODE_ENV !== "production") {
+      mergeUnsanitizedObjectProps(host, config);
+    }
+    const mergedConfig = host.template.staticConfig;
+    if (opts?.transient !== void 0) {
+      host.template.setTransientPropPaths(opts.transient, mergedConfig);
+    }
+    if (opts?.static !== void 0) {
+      host.template.setStaticPropPaths(opts.static, mergedConfig);
+    }
+  }
 };
 
+// shared/src/propTypes/utils.ts
+var import_fast_deep_equal = __toESM(require_fast_deep_equal());
+
 // shared/src/utils/memoizeFn.ts
 function memoizeFn(producer) {
   const cache2 = /* @__PURE__ */ new WeakMap();
@@ -5021,6 +5057,18 @@ function iterateOnAny(path, config, map) {
   }
 }
 
+// shared/src/utils/defaultPropValues.ts
+var objectPropConfigRegistry = /* @__PURE__ */ new Map();
+function objectPropConfigRegistryKey(projectId, sheetId, objectKey) {
+  return "".concat(projectId, "\0").concat(sheetId, "\0").concat(objectKey);
+}
+function registerObjectPropConfig(projectId, sheetId, objectKey, config) {
+  objectPropConfigRegistry.set(
+    objectPropConfigRegistryKey(projectId, sheetId, objectKey),
+    config
+  );
+}
+
 // core/src/sheetObjects/SheetObjectTemplate.ts
 function isObjectEmpty(obj) {
   return typeof obj === "object" && obj !== null && Object.keys(obj).length === 0;
@@ -5067,6 +5115,12 @@ var SheetObjectTemplate = class {
       objectKey,
       this._transientPropPaths
     );
+    registerObjectPropConfig(
+      this.address.projectId,
+      this.address.sheetId,
+      objectKey,
+      config
+    );
     this.pointerToSheetState = this.sheetTemplate.project.pointers.historic.sheetsById[this.address.sheetId];
     this.pointerToStaticOverrides = this.pointerToSheetState.staticOverrides.byObject[this.address.objectKey];
     this.pointerToAhistoricSheetState = this.sheetTemplate.project.pointers.ahistoric.sheetsById[this.address.sheetId];
@@ -5137,6 +5191,29 @@ var SheetObjectTemplate = class {
       config
     );
   }
+  addProps(config) {
+    const existing = this._config.get();
+    const additional = compound(config);
+    for (const key of Object.keys(additional.props)) {
+      if (Object.prototype.hasOwnProperty.call(existing.props, key)) {
+        throw new InvalidArgumentError(
+          'Cannot add prop "'.concat(key, '" because it already exists on object "').concat(this.address.objectKey, '".')
+        );
+      }
+    }
+    const merged = compoundFromSanitizedProps({
+      ...existing.props,
+      ...additional.props
+    });
+    this._config.set(merged);
+    registerObjectPropConfig(
+      this.address.projectId,
+      this.address.sheetId,
+      this.address.objectKey,
+      merged
+    );
+    this._stripNonPersistingPropsFromAhistoricState();
+  }
   setTransientPropPaths(transient, config) {
     this._transientPropPaths = normalizeTransientPropPaths(
       transient,
@@ -6523,8 +6600,7 @@ function parseOutlineNamespacePath(namespacePath, fnName) {
 }
 
 // core/src/sheets/TheatreSheet.ts
-var import_fast_deep_equal = __toESM(require_fast_deep_equal());
-var weakMapOfUnsanitizedProps = /* @__PURE__ */ new WeakMap();
+var import_fast_deep_equal2 = __toESM(require_fast_deep_equal());
 var TheatreSheet = class {
   get type() {
     return "Theatre_Sheet_PublicAPI";
@@ -6546,9 +6622,9 @@ var TheatreSheet = class {
     const actions = opts?.__actions__THIS_API_IS_UNSTABLE_AND_WILL_CHANGE_IN_THE_NEXT_VERSION;
     if (existingObject) {
       if (process.env.NODE_ENV !== "production") {
-        const prevConfig = weakMapOfUnsanitizedProps.get(existingObject);
+        const prevConfig = getUnsanitizedObjectProps(existingObject);
         if (prevConfig) {
-          if (!(0, import_fast_deep_equal.default)(config, prevConfig)) {
+          if (!(0, import_fast_deep_equal2.default)(config, prevConfig)) {
             if (opts?.reconfigure === true) {
               const sanitizedConfig = compound(config);
               existingObject.template.reconfigure(sanitizedConfig);
@@ -6573,7 +6649,7 @@ var TheatreSheet = class {
                   )
                 );
               }
-              weakMapOfUnsanitizedProps.set(existingObject, config);
+              setUnsanitizedObjectProps(existingObject, config);
               return existingObject.publicApi;
             } else {
               throw new Error(
@@ -6623,7 +6699,7 @@ var TheatreSheet = class {
         opts?.static
       );
       if (process.env.NODE_ENV !== "production") {
-        weakMapOfUnsanitizedProps.set(object, config);
+        setUnsanitizedObjectProps(object, config);
       }
       if (opts?.showPropsOf !== void 0) {
         object.template.setShowPropsOf(
@@ -8146,6 +8222,15 @@ var Project = class {
       });
     }
   }
+  /** Re-initialize studio state from this project's `config.state`. */
+  async reinitializeStateFromConfig() {
+    if (!this._studio) {
+      throw new Error(
+        "Cannot reinitialize project ".concat(this.address.projectId, ": not attached to studio")
+      );
+    }
+    await initialiseProjectState(this._studio, this, this.config.state);
+  }
 };
 
 // shared/src/utils/sanitizers.ts
@@ -8270,14 +8355,14 @@ var TheatreProject = class {
 };
 
 // core/src/coreExports.ts
-var import_fast_deep_equal2 = __toESM(require_fast_deep_equal());
+var import_fast_deep_equal3 = __toESM(require_fast_deep_equal());
 var import_theatre_dataverse21 = require("@unseenco/theatre-dataverse");
 var import_theatre_dataverse22 = require("@unseenco/theatre-dataverse");
 function getProject(id, config = {}) {
   const existingProject = projectsSingleton_default.get(id);
   if (existingProject) {
     if (process.env.NODE_ENV !== "production") {
-      if (!(0, import_fast_deep_equal2.default)(config, existingProject.config)) {
+      if (!(0, import_fast_deep_equal3.default)(config, existingProject.config)) {
         throw new Error(
           'You seem to have called Theatre.getProject("'.concat(id, '", config) twice, with different config objects. ') + "This is disallowed because changing the config of a project on the fly can lead to hard-to-debug issues.\n\nYou can fix this by either calling Theatre.getProject() once per projectId, or calling it multiple times but with the exact same config."
         );
@@ -8367,7 +8452,7 @@ var CoreBundle = class {
     return "Theatre_CoreBundle";
   }
   get version() {
-    return "0.1.16";
+    return "0.1.17";
   }
   getBitsForStudio(studio, callback) {
     if (this._studio) {