@emuanalytics/flow-rdf-core 0.0.19 → 0.0.21

package/dist/index.cjs

@@ -33,6 +33,23 @@ const Debug__default = /*#__PURE__*/_interopDefaultCompat(Debug);
 const EventEmitter__default = /*#__PURE__*/_interopDefaultCompat(EventEmitter);
 const maplibre__default = /*#__PURE__*/_interopDefaultCompat(maplibre);
 
+const mockGlobal = {};
+function getGlobal() {
+  if (typeof globalThis !== "undefined") {
+    return globalThis;
+  }
+  if (typeof window !== "undefined") {
+    return window;
+  }
+  if (typeof global !== "undefined") {
+    return global;
+  }
+  if (typeof self !== "undefined") {
+    return self;
+  }
+  return mockGlobal;
+}
+
 function deferred() {
   let methods;
   const promise = new Promise((resolve, reject) => {
@@ -41,14 +58,14 @@ function deferred() {
   return Object.assign(promise, methods);
 }
 
-var __defProp$c = Object.defineProperty;
-var __defNormalProp$c = (obj, key, value) => key in obj ? __defProp$c(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$c = (obj, key, value) => {
-  __defNormalProp$c(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$d = Object.defineProperty;
+var __defNormalProp$d = (obj, key, value) => key in obj ? __defProp$d(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$d = (obj, key, value) => {
+  __defNormalProp$d(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const FLOW_GLOBAL = "FDBG";
-const CONSOLE_HIGHLIGHT_STYLE = `
+const CONSOLE_HIGHLIGHT_STYLE$1 = `
   padding: 2px 4px;
   border-radius: 2px;
   background: #389DFF;
@@ -65,8 +82,8 @@ class Debugger {
    */
   constructor(context) {
     this.context = context;
-    __publicField$c(this, "spyDisposer");
-    __publicField$c(this, "watchDisposers", {});
+    __publicField$d(this, "spyDisposer");
+    __publicField$d(this, "watchDisposers", {});
   }
   /**
    * Install a 'watch' for the specified context state property path.
@@ -147,17 +164,17 @@ class Debugger {
     }
   }
   spyListener(event) {
-    console.log(`%cspy`, CONSOLE_HIGHLIGHT_STYLE, event);
+    console.log(`%cspy`, CONSOLE_HIGHLIGHT_STYLE$1, event);
   }
   logStateValue(path) {
     const value = toJSHelper(this.context.state.get(path), { recurseEverything: false });
-    console.log(`%cwatch%c %s`, CONSOLE_HIGHLIGHT_STYLE, CONSOLE_BOLD_STYLE, path, value);
+    console.log(`%cwatch%c %s`, CONSOLE_HIGHLIGHT_STYLE$1, CONSOLE_BOLD_STYLE, path, value);
   }
 }
 function installGlobalDebugger(dbg) {
   console.log(
     `%cFlow.w RDF Debbugger`,
-    CONSOLE_HIGHLIGHT_STYLE,
+    CONSOLE_HIGHLIGHT_STYLE$1,
     `Enabled for context '${dbg.context.id}' - access using ${FLOW_GLOBAL} in web developer console.`
   );
   const g = typeof global !== "undefined" ? global : window;
@@ -253,16 +270,16 @@ function toJSHelper(source, options, __alreadySeen = null) {
   return res;
 }
 
-var __defProp$b = Object.defineProperty;
-var __defNormalProp$b = (obj, key, value) => key in obj ? __defProp$b(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$b = (obj, key, value) => {
-  __defNormalProp$b(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$c = Object.defineProperty;
+var __defNormalProp$c = (obj, key, value) => key in obj ? __defProp$c(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$c = (obj, key, value) => {
+  __defNormalProp$c(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const debug$4 = Debug__default("flow:map-registry");
 class MapRegistry {
   constructor() {
-    __publicField$b(this, "_maps", /* @__PURE__ */ new Map());
+    __publicField$c(this, "_maps", /* @__PURE__ */ new Map());
   }
   /**
    * Register a Flo.w map.
@@ -304,16 +321,16 @@ class MapRegistry {
   }
 }
 
-var __defProp$a = Object.defineProperty;
-var __defNormalProp$a = (obj, key, value) => key in obj ? __defProp$a(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$a = (obj, key, value) => {
-  __defNormalProp$a(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$b = Object.defineProperty;
+var __defNormalProp$b = (obj, key, value) => key in obj ? __defProp$b(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$b = (obj, key, value) => {
+  __defNormalProp$b(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const debug$3 = Debug__default("flow:query-registry");
 class QueryRegistry {
   constructor() {
-    __publicField$a(this, "_queries", /* @__PURE__ */ new Map());
+    __publicField$b(this, "_queries", /* @__PURE__ */ new Map());
   }
   /**
    * Register a Flo.w reactive query.
@@ -353,10 +370,10 @@ class QueryRegistry {
   }
 }
 
-var __defProp$9 = Object.defineProperty;
-var __defNormalProp$9 = (obj, key, value) => key in obj ? __defProp$9(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$9 = (obj, key, value) => {
-  __defNormalProp$9(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$a = Object.defineProperty;
+var __defNormalProp$a = (obj, key, value) => key in obj ? __defProp$a(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$a = (obj, key, value) => {
+  __defNormalProp$a(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const DEFAULT_FLOW_HOST = "https://flow.emu-analytics.net";
@@ -373,13 +390,13 @@ const _FlowContext = class _FlowContext {
    * @param enableDebug Set to `true` to enable the debugger.
    */
   constructor(options) {
-    __publicField$9(this, "_options");
-    __publicField$9(this, "flowClient");
-    __publicField$9(this, "state");
-    __publicField$9(this, "maps", new MapRegistry());
-    __publicField$9(this, "queries", new QueryRegistry());
+    __publicField$a(this, "_options");
+    __publicField$a(this, "flowClient");
+    __publicField$a(this, "state");
+    __publicField$a(this, "maps", new MapRegistry());
+    __publicField$a(this, "queries", new QueryRegistry());
     /** The Flo.w debugger. Available as `window.FDBG` in the browser's web developer console. */
-    __publicField$9(this, "debugger");
+    __publicField$a(this, "debugger");
     this._options = {
       ..._FlowContext._defaultOptions,
       ...options
@@ -403,23 +420,23 @@ const _FlowContext = class _FlowContext {
     return expression.value;
   }
 };
-__publicField$9(_FlowContext, "_defaultOptions", {
+__publicField$a(_FlowContext, "_defaultOptions", {
   id: DEFAULT_CONTEXT_ID,
   host: DEFAULT_FLOW_HOST,
   enableDebug: false
 });
 let FlowContext = _FlowContext;
 
-var __defProp$8 = Object.defineProperty;
-var __defNormalProp$8 = (obj, key, value) => key in obj ? __defProp$8(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$8 = (obj, key, value) => {
-  __defNormalProp$8(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$9 = Object.defineProperty;
+var __defNormalProp$9 = (obj, key, value) => key in obj ? __defProp$9(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$9 = (obj, key, value) => {
+  __defNormalProp$9(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const debug$2 = Debug__default("flow:context-registry");
 const _ContextRegistry = class _ContextRegistry {
   constructor() {
-    __publicField$8(this, "_contexts", /* @__PURE__ */ new Map());
+    __publicField$9(this, "_contexts", /* @__PURE__ */ new Map());
   }
   /**
    * Initialize a new Flo.w context.
@@ -462,12 +479,85 @@ const _ContextRegistry = class _ContextRegistry {
     return deferredContext?.deferred;
   }
 };
-__publicField$8(_ContextRegistry, "_defaultOptions", {
+__publicField$9(_ContextRegistry, "_defaultOptions", {
   id: DEFAULT_CONTEXT_ID,
   host: "https://flow.emu-analytics.net"
 });
 let ContextRegistry = _ContextRegistry;
-const globalContextRegistry = new ContextRegistry();
+
+var __defProp$8 = Object.defineProperty;
+var __defNormalProp$8 = (obj, key, value) => key in obj ? __defProp$8(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$8 = (obj, key, value) => {
+  __defNormalProp$8(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+class FlowRdfCoreGlobals {
+  constructor() {
+    /**
+     * FlowRdfCoreGlobals version.
+     * Compatiblity with other versions loaded in memory as long as this version matches.
+     * It indicates that the global state still stores similar information
+     *
+     * N.B: this version is unrelated to the package version.
+     */
+    __publicField$8(this, "version", 1);
+    __publicField$8(this, "globalContextRegistry", new ContextRegistry());
+  }
+}
+let canMergeGlobalState = true;
+let isolateCalled = false;
+let globalState = function() {
+  const global = getGlobal();
+  if (global.__flowRdfCoreInstanceCount > 0 && !global.__flowRdfCoreGlobals) {
+    canMergeGlobalState = false;
+  }
+  if (global.__flowRdfCoreGlobals && global.__flowRdfCoreGlobals.version !== new FlowRdfCoreGlobals().version) {
+    canMergeGlobalState = false;
+  }
+  if (!canMergeGlobalState) {
+    setTimeout(() => {
+      if (!isolateCalled) {
+        throw new Error(
+          'There are multiple, different versions of FlowRdfCore active. Make sure FlowRdfCore is loaded only once or use `configure({ isolateGlobalState: true })`",'
+        );
+      }
+    }, 1);
+    return new FlowRdfCoreGlobals();
+  } else if (global.__flowRdfCoreGlobals) {
+    global.__flowRdfCoreInstanceCount += 1;
+    if (!global.__mobxGlobals.UNCHANGED) {
+      global.__mobxGlobals.UNCHANGED = {};
+    }
+    return global.__flowRdfCoreGlobals;
+  } else {
+    global.__mobxInstanceCount = 1;
+    return global.__flowRdfCoreGlobals = new FlowRdfCoreGlobals();
+  }
+}();
+function isolateGlobalState() {
+  isolateCalled = true;
+  if (canMergeGlobalState) {
+    const global = getGlobal();
+    if (--global.__flowRdfCoreInstanceCount === 0) {
+      global.__flowRdfCoreGlobals = void 0;
+    }
+    globalState = new FlowRdfCoreGlobals();
+  }
+}
+function getGlobalState() {
+  return globalState;
+}
+
+const version = "0.0.21";
+
+const CONSOLE_HIGHLIGHT_STYLE = `
+  padding: 2px 4px;
+  border-radius: 2px;
+  background: #389DFF;
+  color: white;`;
+function announce() {
+  console.log("%cFlo.w RDF Core v%s", CONSOLE_HIGHLIGHT_STYLE, version);
+}
 
 var __defProp$7 = Object.defineProperty;
 var __defNormalProp$7 = (obj, key, value) => key in obj ? __defProp$7(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -2492,6 +2582,7 @@ const _FlowMap = class _FlowMap extends EventEmitter__default {
     }
   }
   async initialize() {
+    const globalContextRegistry = getGlobalState().globalContextRegistry;
     this._context = await globalContextRegistry.getContext(this._options.contextId);
     this._style.bindState(this._context.state);
     const baseStyle = await this.loadBaseStyle(this._options.baseStyle);
@@ -2603,7 +2694,7 @@ const _Query = class _Query {
     if (transformFn) {
       this._transformFn = transformFn;
     }
-    globalContextRegistry.getContext(this._options?.contextId).then((context) => {
+    getGlobalState().globalContextRegistry.getContext(this._options?.contextId).then((context) => {
       context.queries.registerQuery(this);
     });
   }
@@ -2617,12 +2708,12 @@ const _Query = class _Query {
     return this._options.id;
   }
   destroy() {
-    globalContextRegistry.getContext(this._options?.contextId).then((context) => {
+    getGlobalState().globalContextRegistry.getContext(this._options?.contextId).then((context) => {
       context.queries.unregisterQuery(this);
     });
   }
   async runImmediately() {
-    const context = await globalContextRegistry.getContext(this._options.contextId);
+    const context = await getGlobalState().globalContextRegistry.getContext(this._options.contextId);
     const queryDefinition = this.queryFn.call(context.state, context.state);
     await this.runQuery(queryDefinition);
     if (this.error) {
@@ -2632,7 +2723,7 @@ const _Query = class _Query {
   }
   async wake() {
     this.sleep();
-    const context = await globalContextRegistry.getContext(this._options.contextId);
+    const context = await getGlobalState().globalContextRegistry.getContext(this._options.contextId);
     this._disposer = mobx.reaction(
       (r) => {
         return this.queryFn.call(context.state, context.state);
@@ -2658,7 +2749,7 @@ const _Query = class _Query {
   }
   async runQuery(queryDefinition) {
     debug(`${this.formattedName}: running query`, queryDefinition);
-    const context = await globalContextRegistry.getContext(this._options.contextId);
+    const context = await getGlobalState().globalContextRegistry.getContext(this._options.contextId);
     try {
       if (queryDefinition === null) {
         mobx.runInAction(() => {
@@ -3075,10 +3166,12 @@ function traceReaction() {
   mobx.trace();
 }
 
-mobx.configure({ isolateGlobalState: true });
+mobx.configure({ isolateGlobalState: false, useProxies: "always" });
+const globalContextRegistry = getGlobalState().globalContextRegistry;
 const initializeContext = globalContextRegistry.initializeContext.bind(globalContextRegistry);
 const uninitializeContext = globalContextRegistry.uninitializeContext.bind(globalContextRegistry);
 const getContext = globalContextRegistry.getContext.bind(globalContextRegistry);
+announce();
 
 exports.MapDataSource = mapFeatureStream.MapDataSource;
 exports.MapLayer = mapFeatureStream.MapLayer;
@@ -3087,6 +3180,7 @@ exports.ContextRegistry = ContextRegistry;
 exports.DEFAULT_CONTEXT_ID = DEFAULT_CONTEXT_ID;
 exports.FlowContext = FlowContext;
 exports.FlowMap = FlowMap;
+exports.FlowRdfCoreGlobals = FlowRdfCoreGlobals;
 exports.MapLayerStyleBuilder = MapLayerStyleBuilder;
 exports.MapStyle = MapStyle;
 exports.Query = Query;
@@ -3095,8 +3189,9 @@ exports.StyleExpression = StyleExpression;
 exports.computed = computed;
 exports.expr = expr;
 exports.getContext = getContext;
-exports.globalContextRegistry = globalContextRegistry;
+exports.getGlobalState = getGlobalState;
 exports.initializeContext = initializeContext;
+exports.isolateGlobalState = isolateGlobalState;
 exports.layerStyle = layerStyle;
 exports.observable = observable;
 exports.query = query;

package/dist/index.d.cts

@@ -40,7 +40,20 @@ declare class ContextRegistry {
     uninitializeContext(contextId?: string): void;
     getContext<TState extends StateStore = StateStore>(id?: string): Promise<FlowContext<TState>>;
 }
-declare const globalContextRegistry: ContextRegistry;
+
+declare class FlowRdfCoreGlobals {
+    /**
+     * FlowRdfCoreGlobals version.
+     * Compatiblity with other versions loaded in memory as long as this version matches.
+     * It indicates that the global state still stores similar information
+     *
+     * N.B: this version is unrelated to the package version.
+     */
+    version: number;
+    globalContextRegistry: ContextRegistry;
+}
+declare function isolateGlobalState(): void;
+declare function getGlobalState(): FlowRdfCoreGlobals;
 
 interface MapStyleOptions {
     id: string;
@@ -72,4 +85,4 @@ declare const initializeContext: <TState extends StateStore = StateStore>(option
 declare const uninitializeContext: (contextId?: string) => void;
 declare const getContext: <TState extends StateStore = StateStore>(id?: string) => Promise<FlowContext<TState>>;
 
-export { ContextRegistry, FlowContext, FlowContextOptions, MapDataSource, MapLayer, MapStyle, MapStyleOptions, MapStyleSpecification, StateStore, computed, getContext, globalContextRegistry, initializeContext, observable, serialize, uninitializeContext };
+export { ContextRegistry, FlowContext, FlowContextOptions, FlowRdfCoreGlobals, MapDataSource, MapLayer, MapStyle, MapStyleOptions, MapStyleSpecification, StateStore, computed, getContext, getGlobalState, initializeContext, isolateGlobalState, observable, serialize, uninitializeContext };

package/dist/index.d.mts

@@ -40,7 +40,20 @@ declare class ContextRegistry {
     uninitializeContext(contextId?: string): void;
     getContext<TState extends StateStore = StateStore>(id?: string): Promise<FlowContext<TState>>;
 }
-declare const globalContextRegistry: ContextRegistry;
+
+declare class FlowRdfCoreGlobals {
+    /**
+     * FlowRdfCoreGlobals version.
+     * Compatiblity with other versions loaded in memory as long as this version matches.
+     * It indicates that the global state still stores similar information
+     *
+     * N.B: this version is unrelated to the package version.
+     */
+    version: number;
+    globalContextRegistry: ContextRegistry;
+}
+declare function isolateGlobalState(): void;
+declare function getGlobalState(): FlowRdfCoreGlobals;
 
 interface MapStyleOptions {
     id: string;
@@ -72,4 +85,4 @@ declare const initializeContext: <TState extends StateStore = StateStore>(option
 declare const uninitializeContext: (contextId?: string) => void;
 declare const getContext: <TState extends StateStore = StateStore>(id?: string) => Promise<FlowContext<TState>>;
 
-export { ContextRegistry, FlowContext, FlowContextOptions, MapDataSource, MapLayer, MapStyle, MapStyleOptions, MapStyleSpecification, StateStore, computed, getContext, globalContextRegistry, initializeContext, observable, serialize, uninitializeContext };
+export { ContextRegistry, FlowContext, FlowContextOptions, FlowRdfCoreGlobals, MapDataSource, MapLayer, MapStyle, MapStyleOptions, MapStyleSpecification, StateStore, computed, getContext, getGlobalState, initializeContext, isolateGlobalState, observable, serialize, uninitializeContext };

package/dist/index.d.ts

@@ -40,7 +40,20 @@ declare class ContextRegistry {
     uninitializeContext(contextId?: string): void;
     getContext<TState extends StateStore = StateStore>(id?: string): Promise<FlowContext<TState>>;
 }
-declare const globalContextRegistry: ContextRegistry;
+
+declare class FlowRdfCoreGlobals {
+    /**
+     * FlowRdfCoreGlobals version.
+     * Compatiblity with other versions loaded in memory as long as this version matches.
+     * It indicates that the global state still stores similar information
+     *
+     * N.B: this version is unrelated to the package version.
+     */
+    version: number;
+    globalContextRegistry: ContextRegistry;
+}
+declare function isolateGlobalState(): void;
+declare function getGlobalState(): FlowRdfCoreGlobals;
 
 interface MapStyleOptions {
     id: string;
@@ -72,4 +85,4 @@ declare const initializeContext: <TState extends StateStore = StateStore>(option
 declare const uninitializeContext: (contextId?: string) => void;
 declare const getContext: <TState extends StateStore = StateStore>(id?: string) => Promise<FlowContext<TState>>;
 
-export { ContextRegistry, FlowContext, FlowContextOptions, MapDataSource, MapLayer, MapStyle, MapStyleOptions, MapStyleSpecification, StateStore, computed, getContext, globalContextRegistry, initializeContext, observable, serialize, uninitializeContext };
+export { ContextRegistry, FlowContext, FlowContextOptions, FlowRdfCoreGlobals, MapDataSource, MapLayer, MapStyle, MapStyleOptions, MapStyleSpecification, StateStore, computed, getContext, getGlobalState, initializeContext, isolateGlobalState, observable, serialize, uninitializeContext };

package/dist/index.mjs

@@ -13,6 +13,23 @@ import 'parsimmon';
 import 'colorbrewer';
 import 'nanoid';
 
+const mockGlobal = {};
+function getGlobal() {
+  if (typeof globalThis !== "undefined") {
+    return globalThis;
+  }
+  if (typeof window !== "undefined") {
+    return window;
+  }
+  if (typeof global !== "undefined") {
+    return global;
+  }
+  if (typeof self !== "undefined") {
+    return self;
+  }
+  return mockGlobal;
+}
+
 function deferred() {
   let methods;
   const promise = new Promise((resolve, reject) => {
@@ -21,14 +38,14 @@ function deferred() {
   return Object.assign(promise, methods);
 }
 
-var __defProp$c = Object.defineProperty;
-var __defNormalProp$c = (obj, key, value) => key in obj ? __defProp$c(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$c = (obj, key, value) => {
-  __defNormalProp$c(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$d = Object.defineProperty;
+var __defNormalProp$d = (obj, key, value) => key in obj ? __defProp$d(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$d = (obj, key, value) => {
+  __defNormalProp$d(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const FLOW_GLOBAL = "FDBG";
-const CONSOLE_HIGHLIGHT_STYLE = `
+const CONSOLE_HIGHLIGHT_STYLE$1 = `
   padding: 2px 4px;
   border-radius: 2px;
   background: #389DFF;
@@ -45,8 +62,8 @@ class Debugger {
    */
   constructor(context) {
     this.context = context;
-    __publicField$c(this, "spyDisposer");
-    __publicField$c(this, "watchDisposers", {});
+    __publicField$d(this, "spyDisposer");
+    __publicField$d(this, "watchDisposers", {});
   }
   /**
    * Install a 'watch' for the specified context state property path.
@@ -127,17 +144,17 @@ class Debugger {
     }
   }
   spyListener(event) {
-    console.log(`%cspy`, CONSOLE_HIGHLIGHT_STYLE, event);
+    console.log(`%cspy`, CONSOLE_HIGHLIGHT_STYLE$1, event);
   }
   logStateValue(path) {
     const value = toJSHelper(this.context.state.get(path), { recurseEverything: false });
-    console.log(`%cwatch%c %s`, CONSOLE_HIGHLIGHT_STYLE, CONSOLE_BOLD_STYLE, path, value);
+    console.log(`%cwatch%c %s`, CONSOLE_HIGHLIGHT_STYLE$1, CONSOLE_BOLD_STYLE, path, value);
   }
 }
 function installGlobalDebugger(dbg) {
   console.log(
     `%cFlow.w RDF Debbugger`,
-    CONSOLE_HIGHLIGHT_STYLE,
+    CONSOLE_HIGHLIGHT_STYLE$1,
     `Enabled for context '${dbg.context.id}' - access using ${FLOW_GLOBAL} in web developer console.`
   );
   const g = typeof global !== "undefined" ? global : window;
@@ -233,16 +250,16 @@ function toJSHelper(source, options, __alreadySeen = null) {
   return res;
 }
 
-var __defProp$b = Object.defineProperty;
-var __defNormalProp$b = (obj, key, value) => key in obj ? __defProp$b(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$b = (obj, key, value) => {
-  __defNormalProp$b(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$c = Object.defineProperty;
+var __defNormalProp$c = (obj, key, value) => key in obj ? __defProp$c(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$c = (obj, key, value) => {
+  __defNormalProp$c(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const debug$4 = Debug("flow:map-registry");
 class MapRegistry {
   constructor() {
-    __publicField$b(this, "_maps", /* @__PURE__ */ new Map());
+    __publicField$c(this, "_maps", /* @__PURE__ */ new Map());
   }
   /**
    * Register a Flo.w map.
@@ -284,16 +301,16 @@ class MapRegistry {
   }
 }
 
-var __defProp$a = Object.defineProperty;
-var __defNormalProp$a = (obj, key, value) => key in obj ? __defProp$a(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$a = (obj, key, value) => {
-  __defNormalProp$a(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$b = Object.defineProperty;
+var __defNormalProp$b = (obj, key, value) => key in obj ? __defProp$b(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$b = (obj, key, value) => {
+  __defNormalProp$b(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const debug$3 = Debug("flow:query-registry");
 class QueryRegistry {
   constructor() {
-    __publicField$a(this, "_queries", /* @__PURE__ */ new Map());
+    __publicField$b(this, "_queries", /* @__PURE__ */ new Map());
   }
   /**
    * Register a Flo.w reactive query.
@@ -333,10 +350,10 @@ class QueryRegistry {
   }
 }
 
-var __defProp$9 = Object.defineProperty;
-var __defNormalProp$9 = (obj, key, value) => key in obj ? __defProp$9(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$9 = (obj, key, value) => {
-  __defNormalProp$9(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$a = Object.defineProperty;
+var __defNormalProp$a = (obj, key, value) => key in obj ? __defProp$a(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$a = (obj, key, value) => {
+  __defNormalProp$a(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const DEFAULT_FLOW_HOST = "https://flow.emu-analytics.net";
@@ -353,13 +370,13 @@ const _FlowContext = class _FlowContext {
    * @param enableDebug Set to `true` to enable the debugger.
    */
   constructor(options) {
-    __publicField$9(this, "_options");
-    __publicField$9(this, "flowClient");
-    __publicField$9(this, "state");
-    __publicField$9(this, "maps", new MapRegistry());
-    __publicField$9(this, "queries", new QueryRegistry());
+    __publicField$a(this, "_options");
+    __publicField$a(this, "flowClient");
+    __publicField$a(this, "state");
+    __publicField$a(this, "maps", new MapRegistry());
+    __publicField$a(this, "queries", new QueryRegistry());
     /** The Flo.w debugger. Available as `window.FDBG` in the browser's web developer console. */
-    __publicField$9(this, "debugger");
+    __publicField$a(this, "debugger");
     this._options = {
       ..._FlowContext._defaultOptions,
       ...options
@@ -383,23 +400,23 @@ const _FlowContext = class _FlowContext {
     return expression.value;
   }
 };
-__publicField$9(_FlowContext, "_defaultOptions", {
+__publicField$a(_FlowContext, "_defaultOptions", {
   id: DEFAULT_CONTEXT_ID,
   host: DEFAULT_FLOW_HOST,
   enableDebug: false
 });
 let FlowContext = _FlowContext;
 
-var __defProp$8 = Object.defineProperty;
-var __defNormalProp$8 = (obj, key, value) => key in obj ? __defProp$8(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$8 = (obj, key, value) => {
-  __defNormalProp$8(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$9 = Object.defineProperty;
+var __defNormalProp$9 = (obj, key, value) => key in obj ? __defProp$9(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$9 = (obj, key, value) => {
+  __defNormalProp$9(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const debug$2 = Debug("flow:context-registry");
 const _ContextRegistry = class _ContextRegistry {
   constructor() {
-    __publicField$8(this, "_contexts", /* @__PURE__ */ new Map());
+    __publicField$9(this, "_contexts", /* @__PURE__ */ new Map());
   }
   /**
    * Initialize a new Flo.w context.
@@ -442,12 +459,85 @@ const _ContextRegistry = class _ContextRegistry {
     return deferredContext?.deferred;
   }
 };
-__publicField$8(_ContextRegistry, "_defaultOptions", {
+__publicField$9(_ContextRegistry, "_defaultOptions", {
   id: DEFAULT_CONTEXT_ID,
   host: "https://flow.emu-analytics.net"
 });
 let ContextRegistry = _ContextRegistry;
-const globalContextRegistry = new ContextRegistry();
+
+var __defProp$8 = Object.defineProperty;
+var __defNormalProp$8 = (obj, key, value) => key in obj ? __defProp$8(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$8 = (obj, key, value) => {
+  __defNormalProp$8(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+class FlowRdfCoreGlobals {
+  constructor() {
+    /**
+     * FlowRdfCoreGlobals version.
+     * Compatiblity with other versions loaded in memory as long as this version matches.
+     * It indicates that the global state still stores similar information
+     *
+     * N.B: this version is unrelated to the package version.
+     */
+    __publicField$8(this, "version", 1);
+    __publicField$8(this, "globalContextRegistry", new ContextRegistry());
+  }
+}
+let canMergeGlobalState = true;
+let isolateCalled = false;
+let globalState = function() {
+  const global = getGlobal();
+  if (global.__flowRdfCoreInstanceCount > 0 && !global.__flowRdfCoreGlobals) {
+    canMergeGlobalState = false;
+  }
+  if (global.__flowRdfCoreGlobals && global.__flowRdfCoreGlobals.version !== new FlowRdfCoreGlobals().version) {
+    canMergeGlobalState = false;
+  }
+  if (!canMergeGlobalState) {
+    setTimeout(() => {
+      if (!isolateCalled) {
+        throw new Error(
+          'There are multiple, different versions of FlowRdfCore active. Make sure FlowRdfCore is loaded only once or use `configure({ isolateGlobalState: true })`",'
+        );
+      }
+    }, 1);
+    return new FlowRdfCoreGlobals();
+  } else if (global.__flowRdfCoreGlobals) {
+    global.__flowRdfCoreInstanceCount += 1;
+    if (!global.__mobxGlobals.UNCHANGED) {
+      global.__mobxGlobals.UNCHANGED = {};
+    }
+    return global.__flowRdfCoreGlobals;
+  } else {
+    global.__mobxInstanceCount = 1;
+    return global.__flowRdfCoreGlobals = new FlowRdfCoreGlobals();
+  }
+}();
+function isolateGlobalState() {
+  isolateCalled = true;
+  if (canMergeGlobalState) {
+    const global = getGlobal();
+    if (--global.__flowRdfCoreInstanceCount === 0) {
+      global.__flowRdfCoreGlobals = void 0;
+    }
+    globalState = new FlowRdfCoreGlobals();
+  }
+}
+function getGlobalState() {
+  return globalState;
+}
+
+const version = "0.0.21";
+
+const CONSOLE_HIGHLIGHT_STYLE = `
+  padding: 2px 4px;
+  border-radius: 2px;
+  background: #389DFF;
+  color: white;`;
+function announce() {
+  console.log("%cFlo.w RDF Core v%s", CONSOLE_HIGHLIGHT_STYLE, version);
+}
 
 var __defProp$7 = Object.defineProperty;
 var __defNormalProp$7 = (obj, key, value) => key in obj ? __defProp$7(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -2472,6 +2562,7 @@ const _FlowMap = class _FlowMap extends EventEmitter {
     }
   }
   async initialize() {
+    const globalContextRegistry = getGlobalState().globalContextRegistry;
     this._context = await globalContextRegistry.getContext(this._options.contextId);
     this._style.bindState(this._context.state);
     const baseStyle = await this.loadBaseStyle(this._options.baseStyle);
@@ -2583,7 +2674,7 @@ const _Query = class _Query {
     if (transformFn) {
       this._transformFn = transformFn;
     }
-    globalContextRegistry.getContext(this._options?.contextId).then((context) => {
+    getGlobalState().globalContextRegistry.getContext(this._options?.contextId).then((context) => {
       context.queries.registerQuery(this);
     });
   }
@@ -2597,12 +2688,12 @@ const _Query = class _Query {
     return this._options.id;
   }
   destroy() {
-    globalContextRegistry.getContext(this._options?.contextId).then((context) => {
+    getGlobalState().globalContextRegistry.getContext(this._options?.contextId).then((context) => {
       context.queries.unregisterQuery(this);
     });
   }
   async runImmediately() {
-    const context = await globalContextRegistry.getContext(this._options.contextId);
+    const context = await getGlobalState().globalContextRegistry.getContext(this._options.contextId);
     const queryDefinition = this.queryFn.call(context.state, context.state);
     await this.runQuery(queryDefinition);
     if (this.error) {
@@ -2612,7 +2703,7 @@ const _Query = class _Query {
   }
   async wake() {
     this.sleep();
-    const context = await globalContextRegistry.getContext(this._options.contextId);
+    const context = await getGlobalState().globalContextRegistry.getContext(this._options.contextId);
     this._disposer = reaction(
       (r) => {
         return this.queryFn.call(context.state, context.state);
@@ -2638,7 +2729,7 @@ const _Query = class _Query {
   }
   async runQuery(queryDefinition) {
     debug(`${this.formattedName}: running query`, queryDefinition);
-    const context = await globalContextRegistry.getContext(this._options.contextId);
+    const context = await getGlobalState().globalContextRegistry.getContext(this._options.contextId);
     try {
       if (queryDefinition === null) {
         runInAction(() => {
@@ -3055,9 +3146,11 @@ function traceReaction() {
   trace();
 }
 
-configure({ isolateGlobalState: true });
+configure({ isolateGlobalState: false, useProxies: "always" });
+const globalContextRegistry = getGlobalState().globalContextRegistry;
 const initializeContext = globalContextRegistry.initializeContext.bind(globalContextRegistry);
 const uninitializeContext = globalContextRegistry.uninitializeContext.bind(globalContextRegistry);
 const getContext = globalContextRegistry.getContext.bind(globalContextRegistry);
+announce();
 
-export { ContextRegistry, DEFAULT_CONTEXT_ID, FlowContext, FlowMap, MapDataSource, MapLayer, MapLayerStyleBuilder, MapStyle, Query, ReactiveExpression, StateStore, StyleExpression, computed, expr, getContext, globalContextRegistry, initializeContext, layerStyle, observable, query, queryMany, queryOne, serialize, traceReaction, uninitializeContext };
+export { ContextRegistry, DEFAULT_CONTEXT_ID, FlowContext, FlowMap, FlowRdfCoreGlobals, MapDataSource, MapLayer, MapLayerStyleBuilder, MapStyle, Query, ReactiveExpression, StateStore, StyleExpression, computed, expr, getContext, getGlobalState, initializeContext, isolateGlobalState, layerStyle, observable, query, queryMany, queryOne, serialize, traceReaction, uninitializeContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emuanalytics/flow-rdf-core",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "description": "",
   "sideEffects": false,
   "type": "module",