tungsten 0.4.14 → 0.5.0

package/dist/browserStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browserStorage.d.ts","sourceRoot":"","sources":["../src/browserStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAgBhD,qBAAa,oBAAoB,CAAC,YAAY,SAAS,MAAM;;IAEzD,GAAG,GAAI,CAAC,SAAS,MAAM,YAAY,GAAG,MAAM,EAAE,KAAK,CAAC,KAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAIjF;IACD,GAAG,GAAI,CAAC,SAAS,MAAM,YAAY,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,YAAY,CAAC,CAAC,CAAC,UAG3E;IACD,KAAK,aAKJ;IACD,GAAG,GAAI,OAAO,MAAM,mBAA4B;IAChD,IAAI,MAAM,WAAiC;IAC3C,MAAM,GAAI,CAAC,SAAS,MAAM,YAAY,GAAG,MAAM,EAAE,KAAK,CAAC,UAGtD;IACD,SAAS,GAAI,CAAC,SAAS,MAAM,YAAY,GAAG,MAAM,EAAE,SAAS,YAAY,EAAE,KAAK,CAAC,UAGhF;IACD,IAAI,GAAI,CAAC,SAAS,MAAM,YAAY,GAAG,MAAM,EAAE,SAAS,YAAY,EAAE,KAAK,CAAC,iCAI3E;CAeJ;AACD,wBAAgB,gBAAgB,CAAC,YAAY,SAAS,MAAM,KAAK,oBAAoB,CAAC,YAAY,CAAC,CAGlG;AAGD,qBAAa,sBAAsB,CAAC,cAAc,SAAS,MAAM;;IAE7D,GAAG,GAAI,CAAC,SAAS,MAAM,cAAc,GAAG,MAAM,EAAE,KAAK,CAAC,KAAG,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAIrF;IACD,GAAG,GAAI,CAAC,SAAS,MAAM,cAAc,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,cAAc,CAAC,CAAC,CAAC,UAG/E;IACD,KAAK,aAKJ;IACD,GAAG,GAAI,OAAO,MAAM,mBAA8B;IAClD,IAAI,MAAM,WAAmC;IAC7C,MAAM,GAAI,CAAC,SAAS,MAAM,cAAc,GAAG,MAAM,EAAE,KAAK,CAAC,UAGxD;IACD,SAAS,GAAI,CAAC,SAAS,MAAM,cAAc,GAAG,MAAM,EAAE,SAAS,YAAY,EAAE,KAAK,CAAC,UAGlF;IACD,IAAI,GAAI,CAAC,SAAS,MAAM,cAAc,GAAG,MAAM,EAAE,SAAS,YAAY,EAAE,KAAK,CAAC,mCAI7E;CAeJ;AACD,wBAAgB,kBAAkB,CAAC,cAAc,SAAS,MAAM,KAAK,sBAAsB,CAAC,cAAc,CAAC,CAG1G"}
+{"version":3,"file":"browserStorage.d.ts","sourceRoot":"","sources":["../src/browserStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAUhD,KAAK,UAAU,CAAC,MAAM,IAAI,MAAM,MAAM,GAAG,MAAM,CAAA;AAO/C,MAAM,WAAW,WAAW,CAAC,OAAO;IAChC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;IACrC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CACnC;AAGD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAErG,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAAwC,CAAA;AACvF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,SAAS,CAAQ,CAAA;AAE3D,KAAK,UAAU,CAAC,MAAM,IAAI;KAAG,CAAC,IAAI,MAAM,MAAM,GAAG,MAAM;CAAE,CAAA;AACzD,KAAK,cAAc,CAAC,MAAM,SAAS,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;AAEpF,KAAK,iBAAiB,CAAC,MAAM,SAAS,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,GACnF;IAAE,WAAW,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;CAAE,GACxC;IAAE,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;CAAE,CAAA;AAE7C,MAAM,MAAM,qBAAqB,CAAC,MAAM,SAAS,MAAM,IAAI;IAEvD,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,cAAc,CAAC,EAAE,MAAM,CAAA;CAC1B,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;AAG7B,qBAAa,sBAAsB,CAAC,MAAM,SAAS,MAAM,EAAE,OAAO,GAAG,SAAS;;gBAW9D,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAW,EAAE,EAAE;QACzD,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAC7G;IASD,CAAC,MAAM,CAAC,OAAO,CAAC;IAyBhB,GAAG,GAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,KAAG,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAIhE;IACD,GAAG,GAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,MAAM,CAAC,CAAC,CAAC,UAG5D;IACD,KAAK,aAGJ;IACD,GAAG,GAAI,OAAO,MAAM,mBAA6B;IACjD,IAAI,MAAM,WAAkC;IAC5C,MAAM,GAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,UAG7C;IAED,SAAS,GAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,KAAK,CAAC,UAavE;IACD,WAAW,GAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,KAAK,CAAC,UAGzE;IACD,cAAc,GAAI,SAAS,YAAY,UAKtC;IAED,IAAI,GAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,KAAK,CAAC,yBAGlE;CAYJ;AAED,qBAAa,oBAAoB,CAAC,YAAY,SAAS,MAAM,EAAE,OAAO,GAAG,SAAS,CAC9E,SAAQ,sBAAsB,CAAC,YAAY,EAAE,OAAO,CAAC;gBACzC,WAAW,EAAE,cAAc,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,SAAS;CAG7F;AAED,qBAAa,sBAAsB,CAAC,cAAc,SAAS,MAAM,EAAE,OAAO,GAAG,SAAS,CAClF,SAAQ,sBAAsB,CAAC,cAAc,EAAE,OAAO,CAAC;gBAC3C,WAAW,EAAE,cAAc,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS;CAGjG;AAuCD,KAAK,YAAY,CAAC,MAAM,SAAS,MAAM,IAAI,qBAAqB,CAAC,MAAM,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAC/F,KAAK,eAAe,CAAC,MAAM,SAAS,MAAM,IAAI,qBAAqB,CAAC,MAAM,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAA;AAEtG,wBAAgB,gBAAgB,CAAC,YAAY,SAAS,UAAU,CAAC,YAAY,CAAC,KAAK,oBAAoB,CAAC,YAAY,CAAC,CAAA;AACrH,wBAAgB,gBAAgB,CAAC,YAAY,SAAS,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,YAAY,CAAC,GAAG,oBAAoB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAA;AAC7I,wBAAgB,gBAAgB,CAAC,YAAY,SAAS,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,YAAY,CAAC,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAA;AAMzI,wBAAgB,kBAAkB,CAAC,cAAc,SAAS,UAAU,CAAC,cAAc,CAAC,KAAK,sBAAsB,CAAC,cAAc,CAAC,CAAA;AAC/H,wBAAgB,kBAAkB,CAAC,cAAc,SAAS,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC,GAAG,sBAAsB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;AACvJ,wBAAgB,kBAAkB,CAAC,cAAc,SAAS,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,cAAc,CAAC,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAA"}

package/dist/browserStorage.js

@@ -1,140 +1,210 @@
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 function _classPrivateFieldInitSpec(e, t, a) { _checkPrivateRedeclaration(e, t), t.set(e, a); }
 function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
 function _classPrivateFieldGet(s, a) { return s.get(_assertClassBrand(s, a)); }
+function _classPrivateFieldSet(s, a, r) { return s.set(_assertClassBrand(s, a), r), r; }
 function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n; throw new TypeError("Private element is not present on this object"); }
-function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
-function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
-function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { isBrowser } from './isBrowser.js';
 import { throwError } from './throwError.js';
-class ServerStorage {
-  constructor() {
-    _defineProperty(this, "get", () => throwError('Browser Storage', 'Browser storage was accessed on the server'));
-    _defineProperty(this, "set", () => throwError('Browser Storage', 'Browser storage was accessed on the server'));
-    _defineProperty(this, "clear", () => throwError('Browser Storage', 'Browser storage was accessed on the server'));
-    _defineProperty(this, "key", () => throwError('Browser Storage', 'Browser storage was accessed on the server'));
-    _defineProperty(this, "delete", () => throwError('Browser Storage', 'Browser storage was accessed on the server'));
-    _defineProperty(this, "subscribe", () => throwError('Browser Storage', 'Browser storage was accessed on the server'));
-    _defineProperty(this, "sync", () => throwError('Browser Storage', 'Browser storage was accessed on the server'));
-  }
-  // @ts-expect-error -- TS wants the getter to return a value
-  get length() {
-    throwError('Browser Storage', 'Browser storage was accessed on the server');
-  }
-}
+export const rawTransformer = {
+  stringify: s => s,
+  parse: s => s
+};
+export const jsonTransformer = JSON;
+// Missing: what get() adds for an absent key - `undefined`, or `never` once defaults are given
+var _storage = /*#__PURE__*/new WeakMap();
 var _subscribers = /*#__PURE__*/new WeakMap();
+var _keysByElement = /*#__PURE__*/new WeakMap();
+var _transformer = /*#__PURE__*/new WeakMap();
+var _defaults = /*#__PURE__*/new WeakMap();
+var _host = /*#__PURE__*/new WeakMap();
+var _relay = /*#__PURE__*/new WeakMap();
+var _absent = /*#__PURE__*/new WeakMap();
 var _push = /*#__PURE__*/new WeakMap();
-export class TungstenLocalStorage {
-  constructor() {
-    _classPrivateFieldInitSpec(this, _subscribers, {});
+export class TungstenBrowserStorage {
+  // host: the window whose `storage` events relay other windows' writes to this one's subscribers
+  constructor({
+    storage,
+    transformer,
+    defaults,
+    host = null
+  }) {
+    _classPrivateFieldInitSpec(this, _storage, void 0);
+    _classPrivateFieldInitSpec(this, _subscribers, new Map());
+    // the reverse index, so a deleted component can be dropped from every key it was on
+    _classPrivateFieldInitSpec(this, _keysByElement, new WeakMap());
+    _classPrivateFieldInitSpec(this, _transformer, void 0);
+    _classPrivateFieldInitSpec(this, _defaults, void 0);
+    _classPrivateFieldInitSpec(this, _host, void 0);
+    // the writing window gets no event; set()/delete()/clear() pushed there already
+    _classPrivateFieldInitSpec(this, _relay, event => {
+      if (event.storageArea !== _classPrivateFieldGet(_storage, this)) return;
+      if (event.key === null) {
+        // clear()
+        for (const key of _classPrivateFieldGet(_subscribers, this).keys()) _classPrivateFieldGet(_push, this).call(this, key, _classPrivateFieldGet(_absent, this).call(this, key));
+        return;
+      }
+      const key = event.key;
+      if (_classPrivateFieldGet(_subscribers, this).has(key)) {
+        // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
+        _classPrivateFieldGet(_push, this).call(this, key, event.newValue === null ? _classPrivateFieldGet(_absent, this).call(this, key) : _classPrivateFieldGet(_transformer, this).parse(event.newValue)); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- the stored string, as get() parses it
+      }
+    });
+    // what an absent key reads as
+    _classPrivateFieldInitSpec(this, _absent, key => _classPrivateFieldGet(_defaults, this)?.[key]);
+    // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- Missing is never exactly when defaults were given
     _defineProperty(this, "get", key => {
-      const v = localStorage.getItem(key);
-      if (v === null) return undefined;else return JSON.parse(v);
+      const v = _classPrivateFieldGet(_storage, this).getItem(key);
+      if (v === null) return _classPrivateFieldGet(_absent, this).call(this, key);
+      return _classPrivateFieldGet(_transformer, this).parse(v); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- what set() stored under the key
     });
     _defineProperty(this, "set", (key, value) => {
-      localStorage.setItem(key, JSON.stringify(value));
+      _classPrivateFieldGet(_storage, this).setItem(key, _classPrivateFieldGet(_transformer, this).stringify(value));
       _classPrivateFieldGet(_push, this).call(this, key, value);
     });
     _defineProperty(this, "clear", () => {
-      localStorage.clear();
-      for (const key in _classPrivateFieldGet(_subscribers, this)) {
-        _classPrivateFieldGet(_push, this).call(this, key, undefined); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- TS is being a wanker about keys of object
-      }
+      _classPrivateFieldGet(_storage, this).clear();
+      for (const key of _classPrivateFieldGet(_subscribers, this).keys()) _classPrivateFieldGet(_push, this).call(this, key, _classPrivateFieldGet(_absent, this).call(this, key));
     });
-    _defineProperty(this, "key", index => localStorage.key(index));
+    _defineProperty(this, "key", index => _classPrivateFieldGet(_storage, this).key(index));
     _defineProperty(this, "delete", key => {
-      localStorage.removeItem(key);
-      _classPrivateFieldGet(_push, this).call(this, key, undefined);
+      _classPrivateFieldGet(_storage, this).removeItem(key);
+      _classPrivateFieldGet(_push, this).call(this, key, _classPrivateFieldGet(_absent, this).call(this, key));
     });
     _defineProperty(this, "subscribe", (element, key) => {
-      const subs = _classPrivateFieldGet(_subscribers, this)[key] || (_classPrivateFieldGet(_subscribers, this)[key] = new Set());
+      let subs = _classPrivateFieldGet(_subscribers, this).get(key);
+      if (subs === undefined) _classPrivateFieldGet(_subscribers, this).set(key, subs = new Set());
       subs.add(element);
+      let keys = _classPrivateFieldGet(_keysByElement, this).get(element);
+      if (keys === undefined) {
+        _classPrivateFieldGet(_keysByElement, this).set(element, keys = new Set());
+        // first subscription: unsubscribe everything when the component is deleted. Function
+        // component stand-ins have no disposal (they are not persistent), so nothing to hook
+        if ('using' in element) element.using({
+          [Symbol.dispose]: () => this.unsubscribeAll(element)
+        });
+      }
+      keys.add(key);
+    });
+    _defineProperty(this, "unsubscribe", (element, key) => {
+      _classPrivateFieldGet(_subscribers, this).get(key)?.delete(element);
+      _classPrivateFieldGet(_keysByElement, this).get(element)?.delete(key);
+    });
+    _defineProperty(this, "unsubscribeAll", element => {
+      const keys = _classPrivateFieldGet(_keysByElement, this).get(element);
+      if (keys === undefined) return;
+      for (const key of keys) _classPrivateFieldGet(_subscribers, this).get(key)?.delete(element);
+      _classPrivateFieldGet(_keysByElement, this).delete(element);
     });
+    // get + subscribe: for use in content, so the component follows the key
     _defineProperty(this, "sync", (element, key) => {
-      const subs = _classPrivateFieldGet(_subscribers, this)[key] || (_classPrivateFieldGet(_subscribers, this)[key] = new Set());
-      subs.add(element);
+      this.subscribe(element, key);
       return this.get(key);
     });
     _classPrivateFieldInitSpec(this, _push, (key, value) => {
-      const subs = _classPrivateFieldGet(_subscribers, this)[key];
-      if (subs) {
-        for (const element of subs) {
-          if ('shouldStoreComponentUpdate' in element && element.shouldStoreComponentUpdate !== undefined) {
-            // eslint-disable-line @typescript-eslint/no-unnecessary-condition -- the field can be declared yet unset
-            if (!element.shouldStoreComponentUpdate(key, value)) {
-              continue;
-            }
-          }
-          //console.log('queueing storage update')
-          element.__queueUpdate();
+      const subs = _classPrivateFieldGet(_subscribers, this).get(key);
+      if (subs === undefined) return;
+      for (const element of subs) {
+        if ('shouldStoreComponentUpdate' in element && element.shouldStoreComponentUpdate !== undefined) {
+          // eslint-disable-line @typescript-eslint/no-unnecessary-condition -- the field can be declared yet unset
+          if (!element.shouldStoreComponentUpdate(key, value)) continue;
         }
+        element.__queueUpdate();
       }
     });
+    _classPrivateFieldSet(_storage, this, storage);
+    _classPrivateFieldSet(_transformer, this, transformer);
+    _classPrivateFieldSet(_defaults, this, defaults);
+    _classPrivateFieldSet(_host, this, host);
+    host?.addEventListener('storage', _classPrivateFieldGet(_relay, this));
+  }
+  // drops the host listener and every subscriber; for tests that build storages per case
+  [Symbol.dispose]() {
+    _classPrivateFieldGet(_host, this)?.removeEventListener('storage', _classPrivateFieldGet(_relay, this));
+    _classPrivateFieldSet(_host, this, null);
+    _classPrivateFieldGet(_subscribers, this).clear();
   }
   get length() {
-    return localStorage.length;
+    return _classPrivateFieldGet(_storage, this).length;
   }
 }
-export function makeLocalStorage() {
-  // add messaging to explain if the storage is accessed on the server
-  return isBrowser ? new TungstenLocalStorage() : new ServerStorage();
-}
-//export type TypedLocalStorage<L extends object> = ReturnType<typeof makeLocalStorage<L>>
-var _subscribers2 = /*#__PURE__*/new WeakMap();
-var _push2 = /*#__PURE__*/new WeakMap();
-export class TungstenSessionStorage {
-  constructor() {
-    _classPrivateFieldInitSpec(this, _subscribers2, {});
-    _defineProperty(this, "get", key => {
-      const v = sessionStorage.getItem(key);
-      if (v === null) return undefined;else return JSON.parse(v);
-    });
-    _defineProperty(this, "set", (key, value) => {
-      sessionStorage.setItem(key, JSON.stringify(value));
-      _classPrivateFieldGet(_push2, this).call(this, key, value);
-    });
-    _defineProperty(this, "clear", () => {
-      sessionStorage.clear();
-      for (const key in _classPrivateFieldGet(_subscribers2, this)) {
-        _classPrivateFieldGet(_push2, this).call(this, key, undefined); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- TS is being a wanker about keys of object
-      }
-    });
-    _defineProperty(this, "key", index => sessionStorage.key(index));
-    _defineProperty(this, "delete", key => {
-      sessionStorage.removeItem(key);
-      _classPrivateFieldGet(_push2, this).call(this, key, undefined);
-    });
-    _defineProperty(this, "subscribe", (element, key) => {
-      const subs = _classPrivateFieldGet(_subscribers2, this)[key] || (_classPrivateFieldGet(_subscribers2, this)[key] = new Set());
-      subs.add(element);
+export class TungstenLocalStorage extends TungstenBrowserStorage {
+  constructor(transformer, defaults) {
+    super({
+      storage: localStorage,
+      transformer,
+      defaults,
+      host: window
     });
-    _defineProperty(this, "sync", (element, key) => {
-      const subs = _classPrivateFieldGet(_subscribers2, this)[key] || (_classPrivateFieldGet(_subscribers2, this)[key] = new Set());
-      subs.add(element);
-      return this.get(key);
-    });
-    _classPrivateFieldInitSpec(this, _push2, (key, value) => {
-      const subs = _classPrivateFieldGet(_subscribers2, this)[key];
-      if (subs) {
-        for (const element of subs) {
-          if ('shouldStoreComponentUpdate' in element && element.shouldStoreComponentUpdate !== undefined) {
-            // eslint-disable-line @typescript-eslint/no-unnecessary-condition -- the field can be declared yet unset
-            if (!element.shouldStoreComponentUpdate(key, value)) {
-              continue;
-            }
-          }
-          //console.log('queueing storage update')
-          element.__queueUpdate();
-        }
-      }
+  }
+}
+// sessionStorage is per tab, so its events only reach frames and windows opened from this tab
+export class TungstenSessionStorage extends TungstenBrowserStorage {
+  constructor(transformer, defaults) {
+    super({
+      storage: sessionStorage,
+      transformer,
+      defaults,
+      host: window
     });
   }
+}
+const serverAccess = () => throwError('Browser Storage', 'Browser storage was accessed on the server');
+// the server stand-in without defaults: every member throws, naming the cause
+class ServerStorage {
+  constructor() {
+    _defineProperty(this, "get", serverAccess);
+    _defineProperty(this, "set", serverAccess);
+    _defineProperty(this, "clear", serverAccess);
+    _defineProperty(this, "key", serverAccess);
+    // nothing to release; disposing on the server is harmless
+    _defineProperty(this, "delete", serverAccess);
+    _defineProperty(this, "subscribe", serverAccess);
+    _defineProperty(this, "unsubscribe", serverAccess);
+    _defineProperty(this, "unsubscribeAll", serverAccess);
+    _defineProperty(this, "sync", serverAccess);
+  }
+  // @ts-expect-error -- TS wants the getter to return a value
+  get length() {
+    serverAccess();
+  }
+  [Symbol.dispose]() {}
+}
+// with defaults: reads answer from them and subscriptions are no-ops, so content that syncs a key
+// renders the same way on both sides; writes still throw, since the server has nowhere to put them
+var _defaults2 = /*#__PURE__*/new WeakMap();
+class ServerDefaultsStorage {
+  constructor(defaults) {
+    _classPrivateFieldInitSpec(this, _defaults2, void 0);
+    _defineProperty(this, "get", key => _classPrivateFieldGet(_defaults2, this)[key]);
+    _defineProperty(this, "set", serverAccess);
+    _defineProperty(this, "clear", serverAccess);
+    _defineProperty(this, "key", () => null);
+    _defineProperty(this, "delete", serverAccess);
+    _defineProperty(this, "subscribe", () => {});
+    _defineProperty(this, "unsubscribe", () => {});
+    _defineProperty(this, "unsubscribeAll", () => {});
+    _defineProperty(this, "sync", (_element, key) => _classPrivateFieldGet(_defaults2, this)[key]);
+    _classPrivateFieldSet(_defaults2, this, defaults);
+  }
   get length() {
-    return sessionStorage.length;
+    return 0;
   }
+  [Symbol.dispose]() {}
+}
+export function makeLocalStorage(options) {
+  const transformer = options?.transformer ?? rawTransformer; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- omittable only for an all-string schema
+  if (isBrowser) return new TungstenLocalStorage(transformer, options?.defaults);
+  return serverStorage(options); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- the stand-in mirrors the members
 }
-export function makeSessionStorage() {
-  // add messaging to explain if the storage is accessed on the server
-  return isBrowser ? new TungstenSessionStorage() : new ServerStorage();
+export function makeSessionStorage(options) {
+  const transformer = options?.transformer ?? rawTransformer; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- as above
+  if (isBrowser) return new TungstenSessionStorage(transformer, options?.defaults);
+  return serverStorage(options); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- as above
 }
-//export type TypedSessionStorage<L extends object> = ReturnType<typeof makeSessionStorage<L>>
+function serverStorage(options) {
+  const defaults = options?.serverDefaults ?? options?.defaults;
+  return defaults === undefined ? new ServerStorage() : new ServerDefaultsStorage(defaults);
+}

package/dist/build/bundle.d.ts

@@ -1,2 +1,2 @@
-export declare function bundle(projectDir: string, quiet?: boolean, targets?: string | string[]): Promise<unknown>;
+export declare function bundle(projectDir: string, quiet?: boolean, targets?: string | string[]): Promise<void>;
 //# sourceMappingURL=bundle.d.ts.map

package/dist/build/bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/build/bundle.ts"],"names":[],"mappings":"AAWA,wBAAsB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,UAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,oBAyD1F"}
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/build/bundle.ts"],"names":[],"mappings":"AAeA,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,UAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDpG"}

package/dist/build/bundle.js

@@ -1,52 +1,57 @@
+import { spawn } from 'child_process';
+import { createRequire } from 'module';
 import { join } from 'path';
-//import type { FrameworkConfigComplete } from '../FrameworkConfig.js'
 import { findProjectDir } from '../findProjectDir.js';
-import { spawnShellCommand } from '../spawnShellCommand.js';
 import { prodBuildFolder, bundleFolder, frameworkDistFolder, clientFolder } from '../settings.js';
-import { errorOut } from '../output.js';
 import { cliLog, cliOut } from '../cliOutput.js';
+import { TungstenError } from '../TungstenError.js';
+// rollup's cli entry from tungsten's own dependency, rather than whatever `npx rollup` would find
+const rollupBin = createRequire(import.meta.url).resolve('rollup/dist/bin/rollup');
+const quoteArg = arg => arg.includes(' ') ? `"${arg}"` : arg;
 // targets: the config's browser floor for rollup's babel step, undefined for the framework default
-export async function bundle(projectDir, quiet = false, targets) {
+export function bundle(projectDir, quiet = false, targets) {
+  if (!quiet) cliOut('Bundling application');
+  const frameworkDir = findProjectDir(import.meta.url);
+  const entryFile = join(projectDir, prodBuildFolder, clientFolder, 'client.js');
+  const outFile = join(projectDir, bundleFolder, 'client.js');
+  const configFile = join(frameworkDir, frameworkDistFolder, 'build/rollup.user.prod.config.js');
+  const args = [rollupBin, '--input', entryFile, '--file', outFile, '--config', configFile, '--inlineDynamicImports', '--format', 'iife'];
+  // the rollup config reads this back; a browserslist query can hold commas, which rollup's own
+  // --environment flag would split on
+  const targetsJson = targets === undefined ? undefined : JSON.stringify(targets);
+  const env = targetsJson === undefined ? process.env : {
+    ...process.env,
+    TUNGSTEN_TARGETS: targetsJson
+  };
+  // runnable by hand from anywhere - every path is absolute - which is how a bundling failure gets
+  // debugged, so it goes in the failure message as well as the log
+  const commandLine = [process.execPath, ...args].map(quoteArg).join(' ') + (targetsJson === undefined ? '' : `\n  with TUNGSTEN_TARGETS=${targetsJson} in the environment`);
+  if (!quiet) cliLog('bundle command:', commandLine);
   return new Promise((resolve, reject) => {
-    if (!quiet) cliOut('Bundling application');
-    const frameworkDir = findProjectDir(import.meta.url);
-    // if (appConfig.useRootComponent) {
-    //     let rootComponent = appConfig.rootComponent as string
-    //    if (rootComponent.endsWith('.jsx')) rootComponent = rootComponent.slice(0, -1)
-    // }
-    const externalModules = [
-      //'node-fetch'
-    ];
-    const includeCd = true; // the command runs in the framework dir so
-    // does not need to cd to it - but keeping
-    // the cd lets the command be run from the 
-    // consuming project folder, which is useful
-    // for debugging, which is basically why we
-    // print it to begin with.
-    const entryFile = join(projectDir, prodBuildFolder, clientFolder, 'client.js');
-    const outFile = join(projectDir, bundleFolder, 'client.js');
-    const configFile = join(frameworkDir, frameworkDistFolder, 'build/rollup.user.prod.config.js');
-    const command = (includeCd ? `cd "${frameworkDir}" && ` : '') + `npx rollup` + ` --input "${entryFile}"` + ` --file "${outFile}"` + ` --config "${configFile}"` + (externalModules.length > 0 ? ` --external ${externalModules.join(',')}` : ``) + ` --inlineDynamicImports --format iife`;
-    if (!quiet) cliLog('bundle command:', command);
-    // the rollup config reads this back; a browserslist query can hold commas, which rollup's own
-    // --environment flag would split on
-    const env = targets === undefined ? process.env : {
-      ...process.env,
-      TUNGSTEN_TARGETS: JSON.stringify(targets)
-    };
-    const subProcess = spawnShellCommand(command, {
-      cwd: frameworkDir,
-      env
+    // No cwd: the paths are absolute, and on Windows a cwd over 260 chars fails the spawn with
+    // ENOENT, which the framework dir reached under a deep project's pnpm store. No shell: node
+    // runs the bin directly, so there is no cmd.exe to find and no quoting to get wrong.
+    const child = spawn(process.execPath, args, {
+      env,
+      stdio: ['ignore', 'pipe', 'pipe']
     });
-    subProcess.on('data', data => {
-      if (!quiet) cliLog(data);
+    // rollup writes its progress and its errors to stderr; kept for the failure message
+    let stderr = '';
+    child.stdout.on('data', data => {
+      if (!quiet) process.stdout.write(data);
     });
-    subProcess.on('close', (code, message) => {
-      if (code === 0) resolve(null);else {
-        // can we show teh error message? Only getting err code now I think
-        errorOut(`bundle process failed with code ${code}, message "${message}"`);
-        reject(code);
+    child.stderr.on('data', data => {
+      stderr += data.toString();
+      if (!quiet) process.stderr.write(data);
+    });
+    const fail = what => reject(new TungstenError(`Bundling failed - rollup ${what}\n${stderr.trim()}\nTo run it by hand: ${commandLine}`));
+    child.on('error', e => fail(`could not be started: ${e.message}`));
+    child.on('close', (code, signal) => {
+      if (code === 0) {
+        resolve();
+        return;
       }
+      fail(code === null ? `was ended by signal ${String(signal)}` : `exited with code ${code}`);
     });
   });
 }

package/dist/build/compileJavascript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compileJavascript.d.ts","sourceRoot":"","sources":["../../src/build/compileJavascript.ts"],"names":[],"mappings":"AAGA,OAAO,QAAQ,MAAM,UAAU,CAAA;AAO/B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAmBtC,KAAK,uBAAuB,GAAG;IAC3B,OAAO,EAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAA;IAClC,WAAW,EAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAA;IACtC,aAAa,EAAE,aAAa,CAAA;IAC5B,cAAc,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,MAAM,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACnC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAE5B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,eAAe,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAA;IAE3F,KAAK,CAAC,EAAE,OAAO,CAAA;IAEf,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAuBD,wBAAsB,iBAAiB,CACnC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,uBAAuB,EACtD,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EACrE,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,UAAO,EAC1E,OAAO,GAAE,wBAA6B,GACvC,OAAO,CAAC,uBAAuB,CAAC,CA4gBlC"}
+{"version":3,"file":"compileJavascript.d.ts","sourceRoot":"","sources":["../../src/build/compileJavascript.ts"],"names":[],"mappings":"AAGA,OAAO,QAAQ,MAAM,UAAU,CAAA;AAO/B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAmBtC,KAAK,uBAAuB,GAAG;IAC3B,OAAO,EAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAA;IAClC,WAAW,EAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAA;IACtC,aAAa,EAAE,aAAa,CAAA;IAC5B,cAAc,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,MAAM,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACnC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAE5B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,eAAe,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAA;IAE3F,KAAK,CAAC,EAAE,OAAO,CAAA;IAEf,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAuBD,wBAAsB,iBAAiB,CACnC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,uBAAuB,EACtD,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EACrE,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,UAAO,EAC1E,OAAO,GAAE,wBAA6B,GACvC,OAAO,CAAC,uBAAuB,CAAC,CA2gBlC"}

package/dist/build/compileJavascript.js

@@ -272,7 +272,6 @@ export async function compileJavascript(projectDir, appConfig, codeLocation, sou
       ignored.push(...testPatterns.map(fromCodeDir));
     }
   }
-  if (appConfig.exclude !== undefined) ignored.push(slash(`${codeLocation}/${appConfig.exclude}`));
   // Which sources each pipeline compiles. Unset, client is everything and raw is nothing; a file
   // may be in both. Dirs and patterns are relative to codeDir. The ignores are not applied
   // here - every file that reaches isClient/isRaw has already passed them, in the initial glob

package/dist/build/makeBabelUserDevConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"makeBabelUserDevConfig.d.ts","sourceRoot":"","sources":["../../src/build/makeBabelUserDevConfig.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAInD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,EAAoC,eAAe,EAAE,MAAM,iDAAiD,CAAA;AAOnH,wBAAgB,sBAAsB,CAClC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,EACnB,kBAAkB,EAAE,MAAM,EAC1B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,qBAAqB,EAAE,MAAM,EAC7B,mBAAmB,EAAE,MAAM,GAAG,SAAS,EACvC,KAAK,EAAE,OAAO,EACd,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAAC,EAChD,kBAAkB,EAAE,eAAe,EACnC,eAAe,EAAE,eAAe,EAChC,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EACxB,WAAW,UAAO,EAClB,GAAG,UAAQ,EACX,QAAQ,UAAO,GAChB,gBAAgB,CA4ClB"}
+{"version":3,"file":"makeBabelUserDevConfig.d.ts","sourceRoot":"","sources":["../../src/build/makeBabelUserDevConfig.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAInD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,EAAoC,eAAe,EAAE,MAAM,iDAAiD,CAAA;AAQnH,wBAAgB,sBAAsB,CAClC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,EACnB,kBAAkB,EAAE,MAAM,EAC1B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,qBAAqB,EAAE,MAAM,EAC7B,mBAAmB,EAAE,MAAM,GAAG,SAAS,EACvC,KAAK,EAAE,OAAO,EACd,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAAC,EAChD,kBAAkB,EAAE,eAAe,EACnC,eAAe,EAAE,eAAe,EAChC,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EACxB,WAAW,UAAO,EAClB,GAAG,UAAQ,EACX,QAAQ,UAAO,GAChB,gBAAgB,CA6ClB"}

package/dist/build/makeBabelUserDevConfig.js

@@ -3,9 +3,10 @@ import { objectCopy } from 'sxy-lib-object-copy';
 import { join } from 'path';
 import { MakeBabelTransformComponentStyles } from '../babelPlugins/BabelTransformComponentStyles.js';
 import { MakeBabelTransformPackageImports } from '../babelPlugins/BabelTransformPackageImports.js';
-import { componentCssFolder, componentCssFile } from '../settings.js';
+import { componentCssFolder, componentCssFile, clientFolder, docInitFile } from '../settings.js';
 import userCommonConfig, { typescriptPreset } from './babel.user.common.config.js';
 import { MakeBabelTransformCssImports } from '../babelPlugins/BabelTransformCssImports.js';
+import { MakeBabelTransformDocInit } from '../babelPlugins/BabelTransformDocInit.js';
 import { MakeBabelAddDevCacheBust } from '../babelPlugins/BabelAddDevCacheBust.js';
 export function makeBabelUserDevConfig(projectDir, absCodeDir, absSourceDir, typescript, absStyleImportBase, buildLocation, buildCodeLocation, packagesCacheLocation, stylesCacheLocation, fresh, skipPackageCompilationFiles, oldDependencyGraph, dependencyGraph, importAliases, promises, watchStyles = true, hmr = false, packages = true) {
   const userDevConfig = objectCopy(userCommonConfig);
@@ -38,6 +39,9 @@ export function makeBabelUserDevConfig(projectDir, absCodeDir, absSourceDir, typ
     watch: watchStyles,
     cacheDir: stylesCacheLocation,
     freshCache: fresh
+  }), MakeBabelTransformDocInit({
+    outputFile: join(buildLocation, clientFolder, docInitFile),
+    projectDir
   }));
   if (hmr) userDevConfig.plugins.push(
   // Dev-only: keeps every relative import's browser-cached URL in sync with the

package/dist/build/makeBabelUserProdConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"makeBabelUserProdConfig.d.ts","sourceRoot":"","sources":["../../src/build/makeBabelUserProdConfig.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAMnD,wBAAgB,uBAAuB,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,EACnB,kBAAkB,EAAE,MAAM,EAC1B,WAAW,UAAO,GACnB,gBAAgB,CAqBlB"}
+{"version":3,"file":"makeBabelUserProdConfig.d.ts","sourceRoot":"","sources":["../../src/build/makeBabelUserProdConfig.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAOnD,wBAAgB,uBAAuB,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,EACnB,kBAAkB,EAAE,MAAM,EAC1B,WAAW,UAAO,GACnB,gBAAgB,CAsBlB"}

package/dist/build/makeBabelUserProdConfig.js

@@ -2,9 +2,10 @@
 import { objectCopy } from 'sxy-lib-object-copy';
 import { join } from 'path';
 import { MakeBabelTransformComponentStyles } from '../babelPlugins/BabelTransformComponentStyles.js';
-import { prodBuildFolder, componentCssFolder, componentCssFile } from '../settings.js';
+import { prodBuildFolder, componentCssFolder, componentCssFile, clientFolder, docInitFile } from '../settings.js';
 import userCommonConfig, { typescriptPreset } from './babel.user.common.config.js';
 import { MakeBabelTransformCssImports } from '../babelPlugins/BabelTransformCssImports.js';
+import { MakeBabelTransformDocInit } from '../babelPlugins/BabelTransformDocInit.js';
 export function makeBabelUserProdConfig(projectDir, absCodeDir, absSourceDir, typescript, absStyleImportBase, watchStyles = true) {
   const userProdConfig = objectCopy(userCommonConfig);
   if (typescript) userProdConfig.presets.push(typescriptPreset()); // eslint-disable-line @typescript-eslint/no-non-null-assertion
@@ -26,6 +27,9 @@ export function makeBabelUserProdConfig(projectDir, absCodeDir, absSourceDir, ty
     cssOutputFile: join(projectDir, prodBuildFolder, componentCssFolder, componentCssFile),
     // should only need to pass one
     watch: watchStyles
+  }), MakeBabelTransformDocInit({
+    outputFile: join(projectDir, prodBuildFolder, clientFolder, docInitFile),
+    projectDir
   }));
   return userProdConfig;
 }

package/dist/cliOutput.d.ts

@@ -8,4 +8,9 @@ export declare function cliAlert(...texts: unknown[]): void;
 export declare function cliWarn(...texts: unknown[]): void;
 export declare function cliError(...texts: unknown[]): void;
 export declare function cliTodo(...texts: unknown[]): void;
+export declare function fatalErrorParts(error: unknown): {
+    headline: string;
+    trace: string;
+};
+export declare function cliFatal(error: unknown): void;
 //# sourceMappingURL=cliOutput.d.ts.map

package/dist/cliOutput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cliOutput.d.ts","sourceRoot":"","sources":["../src/cliOutput.ts"],"names":[],"mappings":"AAMA,wBAAgB,MAAM,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAGzC;AAGD,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE1C;AACD,wBAAgB,MAAM,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAEzC;AACD,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE3C;AACD,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE1C;AACD,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE1C;AACD,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE3C;AACD,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE1C;AACD,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE3C;AACD,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE1C"}
+{"version":3,"file":"cliOutput.d.ts","sourceRoot":"","sources":["../src/cliOutput.ts"],"names":[],"mappings":"AAMA,wBAAgB,MAAM,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAGzC;AAGD,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE1C;AACD,wBAAgB,MAAM,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAEzC;AACD,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE3C;AACD,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE1C;AACD,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE1C;AACD,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE3C;AACD,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE1C;AACD,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE3C;AACD,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,QAE1C;AAID,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAInF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,QAItC"}

package/dist/cliOutput.js

@@ -32,4 +32,26 @@ export function cliError(...texts) {
 }
 export function cliTodo(...texts) {
   console.log(...['ToDo:', ...texts].map(t => chalk.yellow(t)));
+}
+// the headline is name + message, whole - a TungstenError's message spans lines; the trace is the
+// frames alone, so the headline is not printed twice
+export function fatalErrorParts(error) {
+  if (!(error instanceof Error)) return {
+    headline: String(error),
+    trace: ''
+  };
+  const frames = (error.stack ?? '').split('\n').filter(line => line.startsWith('    at '));
+  return {
+    headline: `${error.name}: ${error.message}`,
+    trace: frames.join('\n')
+  };
+}
+// a command that dies: red headline, dimmed frames, in place of node's uncaught-exception dump
+export function cliFatal(error) {
+  const {
+    headline,
+    trace
+  } = fatalErrorParts(error);
+  console.log(chalk.brightred(headline));
+  if (trace !== '') console.log(chalk.mediumgrey(trace));
 }

package/dist/components/Link.d.ts

@@ -9,6 +9,6 @@ export type LinkProps = {
 export declare class Link extends TungstenSimpleComponent<LinkProps> {
     href: string;
     click: (event: AnchorMouseEvent) => void;
-    content: () => ContentNode;
+    content: () => import("../ContentNode.js").ContentNodeElement;
 }
 //# sourceMappingURL=Link.d.ts.map

package/dist/components/Link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../src/components/Link.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAG3D,MAAM,MAAM,SAAS,GAAG;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,EAAE,EAAE,IAAI,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAA;CACxB,CAAA;AAED,qBAAa,IAAK,SAAQ,uBAAuB,CAAC,SAAS,CAAC;IACxD,IAAI,SAIe;IACnB,KAAK,GAAI,OAAO,gBAAgB,UAgB/B;IACD,OAAO,oBAUN;CACJ"}
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../src/components/Link.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAG3D,MAAM,MAAM,SAAS,GAAG;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,EAAE,EAAE,IAAI,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAA;CACxB,CAAA;AAED,qBAAa,IAAK,SAAQ,uBAAuB,CAAC,SAAS,CAAC;IACxD,IAAI,SAIe;IACnB,KAAK,GAAI,OAAO,gBAAgB,UAgB/B;IACD,OAAO,uDAUN;CACJ"}

package/dist/components/NativeHtml.d.ts

@@ -0,0 +1,10 @@
+import type { ContentNodeHtml } from '../indexInner.js';
+import { TungstenSimpleComponent } from '../Components.jsx';
+export interface NativeHtmlProps {
+    children: ContentNodeHtml | ContentNodeHtml[];
+}
+export declare class NativeHtml extends TungstenSimpleComponent<NativeHtmlProps> {
+    static __opaque: boolean;
+    content: () => ContentNodeHtml | ContentNodeHtml[];
+}
+//# sourceMappingURL=NativeHtml.d.ts.map

package/dist/components/NativeHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeHtml.d.ts","sourceRoot":"","sources":["../../src/components/NativeHtml.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,eAAe,GAAG,eAAe,EAAE,CAAA;CAChD;AAGD,qBAAa,UAAW,SAAQ,uBAAuB,CAAC,eAAe,CAAC;IACpE,OAAgB,QAAQ,UAAO;IAC/B,OAAO,4CAA4B;CACtC"}

package/dist/components/NativeHtml.js

@@ -0,0 +1,12 @@
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { TungstenSimpleComponent } from "../Components.js";
+// renders its children once and is never updated by its parent again: markup for DOM manipulation
+export class NativeHtml extends TungstenSimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => this.props.children);
+  }
+}
+_defineProperty(NativeHtml, "__opaque", true);

package/dist/components/PopMessages.d.ts

@@ -6,7 +6,7 @@ type Props = {
 };
 export declare class PopMessages extends TungstenSimpleInternalStoreComponent<Props> {
     clientInit: () => void;
-    content: () => import("../ContentNode.js").ContentNode;
+    content: () => import("../ContentNode.js").ContentNodeElement | null;
 }
 export {};
 //# sourceMappingURL=PopMessages.d.ts.map