@unseenco/theatre-core 0.2.1 → 0.2.3

package/dist/index.mjs

@@ -4183,6 +4183,14 @@ function setDeepImmutable(obj, path, replace) {
 
 // core/src/sequences/sequenceVariants.ts
 import { val as val3 } from "@unseenco/theatre-dataverse";
+
+// shared/src/utils/sheetProps.ts
+var SHEET_PROPS_OBJECT_KEY = "__theatre_sheet_props__";
+function isSheetPropsObjectKey(objectKey) {
+  return objectKey === SHEET_PROPS_OBJECT_KEY;
+}
+
+// core/src/sequences/sequenceVariants.ts
 var DEFAULT_SEQUENCE_VARIANT = "default";
 function mergeSequenceTrackMaps(defaultTracks, overrideTracks, activeVariant) {
   const merged = {};
@@ -4212,6 +4220,9 @@ function getDefaultStaticOverridesByObject(sheetState) {
   return sheetState?.staticOverrides?.byObject;
 }
 function getEffectiveStaticOverrideForObject(sheetState, variantId, objectKey) {
+  if (isSheetPropsObjectKey(objectKey)) {
+    return getDefaultStaticOverridesByObject(sheetState)?.[objectKey];
+  }
   const defaultOverrides = getDefaultStaticOverridesByObject(sheetState)?.[objectKey];
   if (variantId === DEFAULT_SEQUENCE_VARIANT) {
     return defaultOverrides;
@@ -4399,7 +4410,8 @@ var SheetObject = class {
           withAhistoricStaticsCache
         );
         const activeVariant = val4(this.sheet.effectiveActiveSequenceVariantD);
-        const statics = val4(this.template.getStaticValues(activeVariant));
+        const staticVariant = isSheetPropsObjectKey(this.address.objectKey) ? DEFAULT_SEQUENCE_VARIANT : activeVariant;
+        const statics = val4(this.template.getStaticValues(staticVariant));
         const withStaticsCache = prism4.memo(
           "withStatics",
           () => /* @__PURE__ */ new WeakMap(),
@@ -4474,10 +4486,11 @@ var SheetObject = class {
   getSequencedValues() {
     return prism4(() => {
       const activeVariant = val4(this.sheet.effectiveActiveSequenceVariantD);
+      const sequenceVariant = isSheetPropsObjectKey(this.address.objectKey) ? DEFAULT_SEQUENCE_VARIANT : activeVariant;
       const tracksToProcessD = prism4.memo(
         "tracksToProcess",
-        () => this.template.getArrayOfValidSequenceTracks(activeVariant),
-        [activeVariant]
+        () => this.template.getArrayOfValidSequenceTracks(sequenceVariant),
+        [sequenceVariant]
       );
       const tracksToProcess = val4(tracksToProcessD);
       const valsAtom = new Atom3({});
@@ -5414,6 +5427,9 @@ var SheetObjectTemplate = class {
       "getArrayOfValidSequenceTracks:".concat(sequenceVariant),
       () => prism5(
         () => {
+          const effectiveSequenceVariant = isSheetPropsObjectKey(
+            this.address.objectKey
+          ) ? DEFAULT_SEQUENCE_VARIANT : sequenceVariant;
           const pointerToSheetState = this.project.pointers.historic.sheetsById[this.address.sheetId];
           val5(pointerToSheetState.variantObjectOverrides);
           const defaultTrackIdByPropPath = valTrackIdByPropPathForObject(
@@ -5421,19 +5437,19 @@ var SheetObjectTemplate = class {
             DEFAULT_SEQUENCE_VARIANT,
             this.address.objectKey
           );
-          const variantTrackIdByPropPath = sequenceVariant === DEFAULT_SEQUENCE_VARIANT ? void 0 : valTrackIdByPropPathForObject(
+          const variantTrackIdByPropPath = effectiveSequenceVariant === DEFAULT_SEQUENCE_VARIANT ? void 0 : valTrackIdByPropPathForObject(
             pointerToSheetState,
-            sequenceVariant,
+            effectiveSequenceVariant,
             this.address.objectKey
           );
           const mergedTrackMap = mergeSequenceTrackMaps(
             defaultTrackIdByPropPath,
             variantTrackIdByPropPath,
-            sequenceVariant
+            effectiveSequenceVariant
           );
-          const unsequencedPropPaths = sequenceVariant === DEFAULT_SEQUENCE_VARIANT ? void 0 : valUnsequencedPropPathsForObject(
+          const unsequencedPropPaths = effectiveSequenceVariant === DEFAULT_SEQUENCE_VARIANT ? void 0 : valUnsequencedPropPathsForObject(
             pointerToSheetState,
-            sequenceVariant,
+            effectiveSequenceVariant,
             this.address.objectKey
           );
           const unsequencedPropPathSet = unsequencedPropPaths ? new Set(unsequencedPropPaths) : void 0;
@@ -6693,6 +6709,11 @@ var TheatreSheet = class {
       key,
       "sheet.object"
     );
+    if (isSheetPropsObjectKey(sanitizedPath)) {
+      throw new InvalidArgumentError(
+        'The key "'.concat(sanitizedPath, '" is reserved for sheet-level props. Use sheet.props() instead of sheet.object().')
+      );
+    }
     const existingObject = internal2.getObject(sanitizedPath);
     const nativeObject = null;
     const actions = opts?.__actions__THIS_API_IS_UNSTABLE_AND_WILL_CHANGE_IN_THE_NEXT_VERSION;
@@ -6789,6 +6810,74 @@ var TheatreSheet = class {
       return object.publicApi;
     }
   }
+  props(config, opts) {
+    const internal2 = privateAPI(this);
+    const objectKey = SHEET_PROPS_OBJECT_KEY;
+    const existingObject = internal2.getSheetPropsObject();
+    const nativeObject = null;
+    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 = getUnsanitizedObjectProps(existingObject);
+        if (prevConfig) {
+          if (!(0, import_fast_deep_equal2.default)(config, prevConfig)) {
+            if (opts?.reconfigure === true) {
+              const sanitizedConfig2 = compound(config);
+              existingObject.template.reconfigure(sanitizedConfig2);
+              if (opts.transient !== void 0) {
+                existingObject.template.setTransientPropPaths(
+                  opts.transient,
+                  sanitizedConfig2
+                );
+              }
+              if (opts.static !== void 0) {
+                existingObject.template.setStaticPropPaths(
+                  opts.static,
+                  sanitizedConfig2
+                );
+              }
+              setUnsanitizedObjectProps(existingObject, config);
+              return existingObject.publicApi;
+            } else {
+              throw new Error(
+                "You seem to have called sheet.props(config) twice, with different values for `config`. Use the same config on repeat calls, or pass `{reconfigure: true}` to change the schema."
+              );
+            }
+          }
+        }
+      }
+      if (actions) {
+        existingObject.template._temp_setActions(actions);
+      }
+      if (opts?.transient !== void 0) {
+        existingObject.template.setTransientPropPaths(
+          opts.transient,
+          existingObject.template.staticConfig
+        );
+      }
+      if (opts?.static !== void 0) {
+        existingObject.template.setStaticPropPaths(
+          opts.static,
+          existingObject.template.staticConfig
+        );
+      }
+      return existingObject.publicApi;
+    }
+    const sanitizedConfig = compound(config);
+    const object = internal2.createObject(
+      objectKey,
+      nativeObject,
+      sanitizedConfig,
+      actions,
+      false,
+      opts?.transient,
+      opts?.static
+    );
+    if (process.env.NODE_ENV !== "production") {
+      setUnsanitizedObjectProps(object, config);
+    }
+    return object.publicApi;
+  }
   get sequence() {
     return privateAPI(this).getSequence().publicApi;
   }
@@ -6813,6 +6902,11 @@ var TheatreSheet = class {
       key,
       'sheet.deleteObject("'.concat(key, '")')
     );
+    if (isSheetPropsObjectKey(sanitizedPath)) {
+      throw new InvalidArgumentError(
+        "Sheet props cannot be detached. They are removed when the sheet instance is unloaded."
+      );
+    }
     const obj = internal2.getObject(sanitizedPath);
     if (!obj) {
       notify.warning(
@@ -6919,9 +7013,12 @@ var Sheet = class {
   }
   getObjects() {
     return Object.values(this._objects.get()).filter(
-      (obj) => !!obj
+      (obj) => !!obj && !isSheetPropsObjectKey(obj.address.objectKey)
     );
   }
+  getSheetPropsObject() {
+    return this.getObject(SHEET_PROPS_OBJECT_KEY);
+  }
   deleteObject(objectKey) {
     const obj = this._objects.get()[objectKey];
     this._objects.reduce((state) => {
@@ -8542,7 +8639,7 @@ var CoreBundle = class {
     return "Theatre_CoreBundle";
   }
   get version() {
-    return "0.2.1";
+    return "0.2.3";
   }
   getBitsForStudio(studio, callback) {
     if (this._studio) {