@valbuild/tanstack 0.124.0

package/dist/ValOverlayContext-87cb022d.esm.js

@@ -0,0 +1,284 @@
+import { c as _toPropertyKey, b as _createForOfIteratorHelper, d as _defineProperty } from './createForOfIteratorHelper-485c2ce1.esm.js';
+import { deepEqual } from '@valbuild/core/patch';
+import React from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+function _classCallCheck(a, n) {
+  if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function");
+}
+
+function _defineProperties(e, r) {
+  for (var t = 0; t < r.length; t++) {
+    var o = r[t];
+    o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o);
+  }
+}
+function _createClass(e, r, t) {
+  return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", {
+    writable: !1
+  }), e;
+}
+
+var LOAD_TIMEOUT_MS = 10000;
+var ValExternalStore = /*#__PURE__*/function () {
+  // Path-keyed cache of every source seen via update(). The single source of
+  // truth: load state and snapshots are both derived from this, so data can be
+  // queried for any combination of paths even before a subscriber registers.
+
+  // Reference-stable per-subscriberId snapshot cache for useSyncExternalStore.
+  // Built lazily from loadedSources in get() and invalidated in update().
+
+  // One-shot listeners used solely by waitForLoad. Kept separate from the
+  // useSyncExternalStore listeners so waitForLoad never has to register (and
+  // leak) a subscriberId.
+
+  function ValExternalStore() {
+    var _this = this;
+    _classCallCheck(this, ValExternalStore);
+    _defineProperty(this, "subscribe", function (paths) {
+      return function (listener) {
+        var subscriberId = createSubscriberId(paths);
+        var existing = _this.listeners.get(subscriberId);
+        if (existing) {
+          existing.push(listener);
+        } else {
+          _this.listeners.set(subscriberId, [listener]);
+        }
+        return function () {
+          var current = _this.listeners.get(subscriberId);
+          if (!current) return;
+          var idx = current.indexOf(listener);
+          if (idx >= 0) current.splice(idx, 1);
+          if (current.length === 0) _this.listeners["delete"](subscriberId);
+        };
+      };
+    });
+    _defineProperty(this, "getSnapshot", function (paths) {
+      return function () {
+        return _this.get(paths);
+      };
+    });
+    _defineProperty(this, "getServerSnapshot", function (paths) {
+      return function () {
+        return _this.get(paths);
+      };
+    });
+    _defineProperty(this, "get", function (paths) {
+      var subscriberId = createSubscriberId(paths);
+      if (_this.snapshots.has(subscriberId)) {
+        return _this.snapshots.get(subscriberId);
+      }
+      // Build the snapshot from the path-keyed loadedSources so data that arrived
+      // before this subscriber registered is still returned. Cache it for a
+      // reference-stable result (required by useSyncExternalStore).
+      var record;
+      var _iterator = _createForOfIteratorHelper(paths),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var p = _step.value;
+          // Json never holds `undefined`, so a defined value means the path loaded.
+          var loaded = _this.loadedSources.get(p);
+          if (loaded !== undefined) {
+            if (!record) {
+              record = {};
+            }
+            record[p] = loaded;
+          }
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      _this.snapshots.set(subscriberId, record);
+      return record;
+    });
+    _defineProperty(this, "hasAllLoaded", function (paths) {
+      var _iterator2 = _createForOfIteratorHelper(paths),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var p = _step2.value;
+          if (!_this.loadedSources.has(p)) {
+            return false;
+          }
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+      return true;
+    });
+    /**
+     * Returns a cached promise that resolves once `update()` has populated
+     * every path in `paths`. The same promise instance is returned for the
+     * same paths until it resolves — required so `React.use` / classic
+     * Suspense doesn't re-suspend on every render.
+     *
+     * If the data never arrives (network failure, a path that is never
+     * `update()`'d, a typo in a module path) the promise would otherwise hang
+     * forever and keep the Suspense boundary in its fallback. To avoid a silent
+     * hang it resolves anyway after `LOAD_TIMEOUT_MS`, logging an error so the
+     * failure is diagnosable while the page still renders with partial data.
+     */
+    _defineProperty(this, "waitForLoad", function (paths) {
+      if (_this.hasAllLoaded(paths)) {
+        return Promise.resolve();
+      }
+      var subscriberId = createSubscriberId(paths);
+      var existing = _this.loadPromises.get(subscriberId);
+      if (existing) {
+        return existing;
+      }
+      var promise = new Promise(function (resolve) {
+        var cleanup = function cleanup() {
+          clearTimeout(timeout);
+          _this.loadListeners["delete"](listener);
+          _this.loadPromises["delete"](subscriberId);
+        };
+        var listener = function listener() {
+          if (_this.hasAllLoaded(paths)) {
+            cleanup();
+            resolve();
+          }
+        };
+        var timeout = setTimeout(function () {
+          var missing = paths.filter(function (p) {
+            return !_this.loadedSources.has(p);
+          });
+          console.error("Val: draft module(s) did not load within ".concat(LOAD_TIMEOUT_MS, "ms; rendering with partial data. Missing: ").concat(missing.join(", ")));
+          cleanup();
+          resolve();
+        }, LOAD_TIMEOUT_MS);
+        // Don't let the pending timer keep a Node process (e.g. the test runner
+        // or SSR) alive; setTimeout returns a number in the browser, where there
+        // is nothing to unref.
+        if (typeof timeout !== "number") {
+          timeout.unref();
+        }
+        _this.loadListeners.add(listener);
+      });
+      _this.loadPromises.set(subscriberId, promise);
+      return promise;
+    });
+    this.listeners = new Map();
+    this.loadPromises = new Map();
+    this.loadedSources = new Map();
+    this.snapshots = new Map();
+    this.loadListeners = new Set();
+  }
+  return _createClass(ValExternalStore, [{
+    key: "update",
+    value:
+    /**
+     * Take a module's source from the editor.
+     *
+     * Returns whether this actually MOVED the value, which the caller needs and
+     * cannot work out for itself: the same source arrives more than once by
+     * design. The editor sends a catch-up snapshot of everything it holds every
+     * time the page becomes a new document — a reload, or the one the dev server does
+     * when a publish rewrites the `.val.ts` files — and most of that snapshot is
+     * content this page already has.
+     *
+     * Without the answer, `ValTanStackProvider` armed its `router.invalidate()` loop on
+     * the arrival rather than on the change, so every publish bought a whole-route
+     * request whether or not the page was out of date. With auto-save on that is
+     * one per pause in typing, which in development is a re-render (and sometimes
+     * a recompile) of the page — and it is what leaves the canvas looking
+     * permanently busy.
+     */
+    function update(path, source) {
+      // `Json` has no `undefined`, so absent and "stored as undefined" cannot be
+      // confused: a miss here means this page has never been given this module.
+      var before = this.loadedSources.get(path);
+      var changed = before === undefined || !deepEqual(before, source);
+      this.loadedSources.set(path, source);
+      if (!changed) {
+        // Nothing downstream to do: every subscriber's snapshot still answers
+        // with the same value, so invalidating them would be a re-render that
+        // shows exactly what is already on screen.
+        return false;
+      }
+      // Invalidate cached snapshots that include this path so the next get()
+      // rebuilds a fresh (new-reference) record, then notify their listeners.
+      for (var _i = 0, _Array$from = Array.from(this.snapshots.keys()); _i < _Array$from.length; _i++) {
+        var subscriberId = _Array$from[_i];
+        if (subscriberId.includes(path)) {
+          // TODO: hash paths instead
+          this.snapshots["delete"](subscriberId);
+        }
+      }
+      var _iterator3 = _createForOfIteratorHelper(this.listeners.keys()),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var _subscriberId = _step3.value;
+          if (_subscriberId.includes(path)) {
+            this.emitChange(_subscriberId);
+          }
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+      for (var _i2 = 0, _Array$from2 = Array.from(this.loadListeners); _i2 < _Array$from2.length; _i2++) {
+        var listener = _Array$from2[_i2];
+        listener();
+      }
+      return true;
+    }
+  }, {
+    key: "emitChange",
+    value: function emitChange(subscriberId) {
+      var _this$listeners$get;
+      var _iterator4 = _createForOfIteratorHelper((_this$listeners$get = this.listeners.get(subscriberId)) !== null && _this$listeners$get !== void 0 ? _this$listeners$get : []),
+        _step4;
+      try {
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var listener = _step4.value;
+          listener();
+        }
+      } catch (err) {
+        _iterator4.e(err);
+      } finally {
+        _iterator4.f();
+      }
+    }
+  }]);
+}();
+function createSubscriberId(paths) {
+  return paths.slice().sort().join("&");
+}
+var ValOverlayContext = /*#__PURE__*/React.createContext({
+  store: undefined,
+  draftMode: false,
+  suspend: false,
+  draftModeReady: undefined,
+  draftSourcesSynced: false
+});
+function ValOverlayProvider(_ref) {
+  var store = _ref.store,
+    draftMode = _ref.draftMode,
+    suspend = _ref.suspend,
+    draftModeReady = _ref.draftModeReady,
+    draftSourcesSynced = _ref.draftSourcesSynced,
+    children = _ref.children;
+  return /*#__PURE__*/jsx(ValOverlayContext.Provider, {
+    value: {
+      store: store,
+      draftMode: draftMode,
+      suspend: suspend,
+      draftModeReady: draftModeReady,
+      draftSourcesSynced: draftSourcesSynced
+    },
+    children: children
+  });
+}
+var useValOverlayContext = function useValOverlayContext() {
+  return React.useContext(ValOverlayContext);
+};
+
+export { ValExternalStore as V, ValOverlayProvider as a, useValOverlayContext as u };

package/dist/ValOverlayContext-abd6ab9a.cjs.prod.js

@@ -0,0 +1,292 @@
+'use strict';
+
+var createForOfIteratorHelper = require('./createForOfIteratorHelper-0324e063.cjs.prod.js');
+var patch = require('@valbuild/core/patch');
+var React = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { 'default': e }; }
+
+var React__default = /*#__PURE__*/_interopDefault(React);
+
+function _classCallCheck(a, n) {
+  if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function");
+}
+
+function _defineProperties(e, r) {
+  for (var t = 0; t < r.length; t++) {
+    var o = r[t];
+    o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, createForOfIteratorHelper._toPropertyKey(o.key), o);
+  }
+}
+function _createClass(e, r, t) {
+  return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", {
+    writable: !1
+  }), e;
+}
+
+var LOAD_TIMEOUT_MS = 10000;
+var ValExternalStore = /*#__PURE__*/function () {
+  // Path-keyed cache of every source seen via update(). The single source of
+  // truth: load state and snapshots are both derived from this, so data can be
+  // queried for any combination of paths even before a subscriber registers.
+
+  // Reference-stable per-subscriberId snapshot cache for useSyncExternalStore.
+  // Built lazily from loadedSources in get() and invalidated in update().
+
+  // One-shot listeners used solely by waitForLoad. Kept separate from the
+  // useSyncExternalStore listeners so waitForLoad never has to register (and
+  // leak) a subscriberId.
+
+  function ValExternalStore() {
+    var _this = this;
+    _classCallCheck(this, ValExternalStore);
+    createForOfIteratorHelper._defineProperty(this, "subscribe", function (paths) {
+      return function (listener) {
+        var subscriberId = createSubscriberId(paths);
+        var existing = _this.listeners.get(subscriberId);
+        if (existing) {
+          existing.push(listener);
+        } else {
+          _this.listeners.set(subscriberId, [listener]);
+        }
+        return function () {
+          var current = _this.listeners.get(subscriberId);
+          if (!current) return;
+          var idx = current.indexOf(listener);
+          if (idx >= 0) current.splice(idx, 1);
+          if (current.length === 0) _this.listeners["delete"](subscriberId);
+        };
+      };
+    });
+    createForOfIteratorHelper._defineProperty(this, "getSnapshot", function (paths) {
+      return function () {
+        return _this.get(paths);
+      };
+    });
+    createForOfIteratorHelper._defineProperty(this, "getServerSnapshot", function (paths) {
+      return function () {
+        return _this.get(paths);
+      };
+    });
+    createForOfIteratorHelper._defineProperty(this, "get", function (paths) {
+      var subscriberId = createSubscriberId(paths);
+      if (_this.snapshots.has(subscriberId)) {
+        return _this.snapshots.get(subscriberId);
+      }
+      // Build the snapshot from the path-keyed loadedSources so data that arrived
+      // before this subscriber registered is still returned. Cache it for a
+      // reference-stable result (required by useSyncExternalStore).
+      var record;
+      var _iterator = createForOfIteratorHelper._createForOfIteratorHelper(paths),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var p = _step.value;
+          // Json never holds `undefined`, so a defined value means the path loaded.
+          var loaded = _this.loadedSources.get(p);
+          if (loaded !== undefined) {
+            if (!record) {
+              record = {};
+            }
+            record[p] = loaded;
+          }
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      _this.snapshots.set(subscriberId, record);
+      return record;
+    });
+    createForOfIteratorHelper._defineProperty(this, "hasAllLoaded", function (paths) {
+      var _iterator2 = createForOfIteratorHelper._createForOfIteratorHelper(paths),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var p = _step2.value;
+          if (!_this.loadedSources.has(p)) {
+            return false;
+          }
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+      return true;
+    });
+    /**
+     * Returns a cached promise that resolves once `update()` has populated
+     * every path in `paths`. The same promise instance is returned for the
+     * same paths until it resolves — required so `React.use` / classic
+     * Suspense doesn't re-suspend on every render.
+     *
+     * If the data never arrives (network failure, a path that is never
+     * `update()`'d, a typo in a module path) the promise would otherwise hang
+     * forever and keep the Suspense boundary in its fallback. To avoid a silent
+     * hang it resolves anyway after `LOAD_TIMEOUT_MS`, logging an error so the
+     * failure is diagnosable while the page still renders with partial data.
+     */
+    createForOfIteratorHelper._defineProperty(this, "waitForLoad", function (paths) {
+      if (_this.hasAllLoaded(paths)) {
+        return Promise.resolve();
+      }
+      var subscriberId = createSubscriberId(paths);
+      var existing = _this.loadPromises.get(subscriberId);
+      if (existing) {
+        return existing;
+      }
+      var promise = new Promise(function (resolve) {
+        var cleanup = function cleanup() {
+          clearTimeout(timeout);
+          _this.loadListeners["delete"](listener);
+          _this.loadPromises["delete"](subscriberId);
+        };
+        var listener = function listener() {
+          if (_this.hasAllLoaded(paths)) {
+            cleanup();
+            resolve();
+          }
+        };
+        var timeout = setTimeout(function () {
+          var missing = paths.filter(function (p) {
+            return !_this.loadedSources.has(p);
+          });
+          console.error("Val: draft module(s) did not load within ".concat(LOAD_TIMEOUT_MS, "ms; rendering with partial data. Missing: ").concat(missing.join(", ")));
+          cleanup();
+          resolve();
+        }, LOAD_TIMEOUT_MS);
+        // Don't let the pending timer keep a Node process (e.g. the test runner
+        // or SSR) alive; setTimeout returns a number in the browser, where there
+        // is nothing to unref.
+        if (typeof timeout !== "number") {
+          timeout.unref();
+        }
+        _this.loadListeners.add(listener);
+      });
+      _this.loadPromises.set(subscriberId, promise);
+      return promise;
+    });
+    this.listeners = new Map();
+    this.loadPromises = new Map();
+    this.loadedSources = new Map();
+    this.snapshots = new Map();
+    this.loadListeners = new Set();
+  }
+  return _createClass(ValExternalStore, [{
+    key: "update",
+    value:
+    /**
+     * Take a module's source from the editor.
+     *
+     * Returns whether this actually MOVED the value, which the caller needs and
+     * cannot work out for itself: the same source arrives more than once by
+     * design. The editor sends a catch-up snapshot of everything it holds every
+     * time the page becomes a new document — a reload, or the one the dev server does
+     * when a publish rewrites the `.val.ts` files — and most of that snapshot is
+     * content this page already has.
+     *
+     * Without the answer, `ValTanStackProvider` armed its `router.invalidate()` loop on
+     * the arrival rather than on the change, so every publish bought a whole-route
+     * request whether or not the page was out of date. With auto-save on that is
+     * one per pause in typing, which in development is a re-render (and sometimes
+     * a recompile) of the page — and it is what leaves the canvas looking
+     * permanently busy.
+     */
+    function update(path, source) {
+      // `Json` has no `undefined`, so absent and "stored as undefined" cannot be
+      // confused: a miss here means this page has never been given this module.
+      var before = this.loadedSources.get(path);
+      var changed = before === undefined || !patch.deepEqual(before, source);
+      this.loadedSources.set(path, source);
+      if (!changed) {
+        // Nothing downstream to do: every subscriber's snapshot still answers
+        // with the same value, so invalidating them would be a re-render that
+        // shows exactly what is already on screen.
+        return false;
+      }
+      // Invalidate cached snapshots that include this path so the next get()
+      // rebuilds a fresh (new-reference) record, then notify their listeners.
+      for (var _i = 0, _Array$from = Array.from(this.snapshots.keys()); _i < _Array$from.length; _i++) {
+        var subscriberId = _Array$from[_i];
+        if (subscriberId.includes(path)) {
+          // TODO: hash paths instead
+          this.snapshots["delete"](subscriberId);
+        }
+      }
+      var _iterator3 = createForOfIteratorHelper._createForOfIteratorHelper(this.listeners.keys()),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var _subscriberId = _step3.value;
+          if (_subscriberId.includes(path)) {
+            this.emitChange(_subscriberId);
+          }
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+      for (var _i2 = 0, _Array$from2 = Array.from(this.loadListeners); _i2 < _Array$from2.length; _i2++) {
+        var listener = _Array$from2[_i2];
+        listener();
+      }
+      return true;
+    }
+  }, {
+    key: "emitChange",
+    value: function emitChange(subscriberId) {
+      var _this$listeners$get;
+      var _iterator4 = createForOfIteratorHelper._createForOfIteratorHelper((_this$listeners$get = this.listeners.get(subscriberId)) !== null && _this$listeners$get !== void 0 ? _this$listeners$get : []),
+        _step4;
+      try {
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var listener = _step4.value;
+          listener();
+        }
+      } catch (err) {
+        _iterator4.e(err);
+      } finally {
+        _iterator4.f();
+      }
+    }
+  }]);
+}();
+function createSubscriberId(paths) {
+  return paths.slice().sort().join("&");
+}
+var ValOverlayContext = /*#__PURE__*/React__default["default"].createContext({
+  store: undefined,
+  draftMode: false,
+  suspend: false,
+  draftModeReady: undefined,
+  draftSourcesSynced: false
+});
+function ValOverlayProvider(_ref) {
+  var store = _ref.store,
+    draftMode = _ref.draftMode,
+    suspend = _ref.suspend,
+    draftModeReady = _ref.draftModeReady,
+    draftSourcesSynced = _ref.draftSourcesSynced,
+    children = _ref.children;
+  return /*#__PURE__*/jsxRuntime.jsx(ValOverlayContext.Provider, {
+    value: {
+      store: store,
+      draftMode: draftMode,
+      suspend: suspend,
+      draftModeReady: draftModeReady,
+      draftSourcesSynced: draftSourcesSynced
+    },
+    children: children
+  });
+}
+var useValOverlayContext = function useValOverlayContext() {
+  return React__default["default"].useContext(ValOverlayContext);
+};
+
+exports.ValExternalStore = ValExternalStore;
+exports.ValOverlayProvider = ValOverlayProvider;
+exports.useValOverlayContext = useValOverlayContext;