@immediately-run/sdk 0.1.0

package/dist/moduleCache.d.ts

@@ -0,0 +1,20 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { EvaluationContext } from './sandboxTypes.js';
+
+declare class ModuleCache {
+    nameResolutionPromises: Record<string, Promise<string>>;
+    evaluationContextPromises: Record<string, Promise<EvaluationContext>>;
+    constructor();
+    private getCacheKey;
+    resolveModuleName(moduleName: string, baseModule?: EvaluationContext): Promise<string>;
+    getEvaluationContext(moduleName: string, baseModule?: EvaluationContext): Promise<EvaluationContext>;
+}
+declare const ModuleCacheContext: react.Context<ModuleCache | null>;
+declare const ModuleCacheContextProvider: ({ children, moduleCache }: {
+    children: ReactNode;
+    moduleCache: ModuleCache;
+}) => react_jsx_runtime.JSX.Element;
+
+export { ModuleCache, ModuleCacheContext, ModuleCacheContextProvider };

package/dist/moduleCache.js

@@ -0,0 +1,40 @@
+import { jsx } from "react/jsx-runtime";
+import { createContext } from "react";
+import { addListener } from "./sandboxUtils";
+class ModuleCache {
+  constructor() {
+    this.nameResolutionPromises = {};
+    this.evaluationContextPromises = {};
+    addListener("compile", () => {
+    });
+  }
+  getCacheKey(mod, moduleName) {
+    return `${mod.evaluation.module.filepath}|${moduleName}`;
+  }
+  resolveModuleName(moduleName, baseModule) {
+    const mod = baseModule ?? module;
+    const cacheKey = this.getCacheKey(mod, moduleName);
+    if (!(cacheKey in this.nameResolutionPromises)) {
+      this.nameResolutionPromises[cacheKey] = mod.resolve(moduleName);
+    }
+    return this.nameResolutionPromises[cacheKey];
+  }
+  getEvaluationContext(moduleName, baseModule) {
+    const mod = baseModule ?? module;
+    const cacheKey = this.getCacheKey(mod, moduleName);
+    if (!(cacheKey in this.evaluationContextPromises)) {
+      this.evaluationContextPromises[cacheKey] = mod.getModuleEvaluationContext(moduleName);
+    }
+    return this.evaluationContextPromises[cacheKey];
+  }
+}
+const ModuleCacheContext = createContext(null);
+const ModuleCacheContextProvider = ({ children, moduleCache }) => {
+  return /* @__PURE__ */ jsx(ModuleCacheContext.Provider, { value: moduleCache, children });
+};
+export {
+  ModuleCache,
+  ModuleCacheContext,
+  ModuleCacheContextProvider
+};
+//# sourceMappingURL=moduleCache.js.map

package/dist/moduleCache.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/moduleCache.tsx"],"sourcesContent":["// based on: https://www.bbss.dev/posts/react-learn-suspense/#fetchcache-provider\n\nimport { createContext, ReactNode, useCallback, useState } from \"react\"\nimport { EvaluationContext } from \"./sandboxTypes\";\nimport { addListener } from \"./sandboxUtils\";\n\nexport class ModuleCache {\n  nameResolutionPromises: Record<string, Promise<string>> = {}\n  evaluationContextPromises: Record<string, Promise<EvaluationContext>> = {}\n\n  constructor() {\n    // reset cache on compile\n    addListener('compile', () => {\n      // NOTE: THIS CAUSES AN UNNECESSARY RELOAD\n      // the <Include> component's module evaluation context promise is replaced\n      // with a new promise for the same value when a compilation occurs which\n      // doesn't affect the current module. Commenting out the following lines\n      // eliminates the unnecessary component state loss.\n      // this.nameResolutionPromises = {};\n      // this.evaluationContextPromises = {};\n    })\n  }\n\n  private getCacheKey(mod:EvaluationContext, moduleName:string):string {\n    return `${mod.evaluation.module.filepath}|${moduleName}`;\n  }\n\n  resolveModuleName(moduleName:string, baseModule?:EvaluationContext):Promise<string> {\n    // note: uses current module as base module if none specified by caller\n    // @ts-ignore\n    const mod = baseModule ?? (module as EvaluationContext);\n    const cacheKey = this.getCacheKey(mod, moduleName);\n    if (!(cacheKey in this.nameResolutionPromises)) {\n      this.nameResolutionPromises[cacheKey] = mod.resolve(moduleName);\n    }\n    return this.nameResolutionPromises[cacheKey];\n  }\n\n  getEvaluationContext(moduleName:string, baseModule?:EvaluationContext):Promise<EvaluationContext> {\n    // note: uses current module as base module if none specified by caller\n    // @ts-ignore\n    const mod = baseModule ?? (module as EvaluationContext);\n    const cacheKey = this.getCacheKey(mod, moduleName);\n    if (!(cacheKey in this.evaluationContextPromises)) {\n      this.evaluationContextPromises[cacheKey] = mod.getModuleEvaluationContext(moduleName);\n    }\n    return this.evaluationContextPromises[cacheKey];\n\n  }\n}\n\nexport const ModuleCacheContext = createContext<null|ModuleCache>(null)\n\nexport const ModuleCacheContextProvider = ({ children, moduleCache }:{ children:ReactNode, moduleCache: ModuleCache }) => {\n\n    return (\n        <ModuleCacheContext.Provider value={moduleCache}>\n            {children}\n        </ModuleCacheContext.Provider>\n    )\n}\n"],"mappings":"AAwDQ;AAtDR,SAAS,qBAAuD;AAEhE,SAAS,mBAAmB;AAErB,MAAM,YAAY;AAAA,EAIvB,cAAc;AAHd,kCAA0D,CAAC;AAC3D,qCAAwE,CAAC;AAIvE,gBAAY,WAAW,MAAM;AAAA,IAQ7B,CAAC;AAAA,EACH;AAAA,EAEQ,YAAY,KAAuB,YAA0B;AACnE,WAAO,GAAG,IAAI,WAAW,OAAO,QAAQ,IAAI,UAAU;AAAA,EACxD;AAAA,EAEA,kBAAkB,YAAmB,YAA+C;AAGlF,UAAM,MAAM,cAAe;AAC3B,UAAM,WAAW,KAAK,YAAY,KAAK,UAAU;AACjD,QAAI,EAAE,YAAY,KAAK,yBAAyB;AAC9C,WAAK,uBAAuB,QAAQ,IAAI,IAAI,QAAQ,UAAU;AAAA,IAChE;AACA,WAAO,KAAK,uBAAuB,QAAQ;AAAA,EAC7C;AAAA,EAEA,qBAAqB,YAAmB,YAA0D;AAGhG,UAAM,MAAM,cAAe;AAC3B,UAAM,WAAW,KAAK,YAAY,KAAK,UAAU;AACjD,QAAI,EAAE,YAAY,KAAK,4BAA4B;AACjD,WAAK,0BAA0B,QAAQ,IAAI,IAAI,2BAA2B,UAAU;AAAA,IACtF;AACA,WAAO,KAAK,0BAA0B,QAAQ;AAAA,EAEhD;AACF;AAEO,MAAM,qBAAqB,cAAgC,IAAI;AAE/D,MAAM,6BAA6B,CAAC,EAAE,UAAU,YAAY,MAAuD;AAEtH,SACI,oBAAC,mBAAmB,UAAnB,EAA4B,OAAO,aAC/B,UACL;AAER;","names":[]}

package/dist/pathUtils.cjs

@@ -0,0 +1,63 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var pathUtils_exports = {};
+__export(pathUtils_exports, {
+  absPath: () => absPath,
+  joinPaths: () => joinPaths
+});
+module.exports = __toCommonJS(pathUtils_exports);
+const PATH_SEPARATOR = "/";
+const joinPaths = (...pathPart) => pathPart.reduce((acc, part) => {
+  const left = acc.endsWith(PATH_SEPARATOR) ? acc.slice(0, -1) : acc;
+  const right = part.startsWith(PATH_SEPARATOR) ? part.substring(1) : part;
+  if (left || acc === PATH_SEPARATOR) {
+    return `${left}${PATH_SEPARATOR}${right}`;
+  }
+  if (part.startsWith(PATH_SEPARATOR)) {
+    return `${PATH_SEPARATOR}${right}`;
+  }
+  return right;
+}, "");
+const absPath = (rawPath) => {
+  const absCandidate = joinPaths.apply(
+    null,
+    rawPath.split(PATH_SEPARATOR).reduce(
+      (partialAbsPath, currentPathPart) => {
+        if (currentPathPart == ".") {
+          return partialAbsPath;
+        }
+        if (currentPathPart == "..") {
+          return partialAbsPath.slice(0, -1);
+        }
+        return partialAbsPath.concat(currentPathPart);
+      },
+      []
+    )
+  );
+  if (absCandidate === "" && rawPath.startsWith(PATH_SEPARATOR)) {
+    return PATH_SEPARATOR;
+  }
+  return absCandidate;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  absPath,
+  joinPaths
+});
+//# sourceMappingURL=pathUtils.cjs.map

package/dist/pathUtils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pathUtils.ts"],"sourcesContent":["const PATH_SEPARATOR = \"/\";\n\nexport const joinPaths = (...pathPart: string[]) => pathPart.reduce((acc, part) => {\n  const left = (acc.endsWith(PATH_SEPARATOR)) ? acc.slice(0, -1) : acc;\n  const right = (part.startsWith(PATH_SEPARATOR)) ? part.substring(1) : part;\n  if (left || acc === PATH_SEPARATOR) {\n    return `${left}${PATH_SEPARATOR}${right}`;\n  }\n  if (part.startsWith(PATH_SEPARATOR)) {\n    return `${PATH_SEPARATOR}${right}`;\n  }\n  return right;\n}, \"\");\n\nexport const absPath = (rawPath: string): string => {\n  const absCandidate = joinPaths.apply(\n    null,\n    rawPath.split(PATH_SEPARATOR).reduce(\n      (partialAbsPath: string[], currentPathPart: string) => {\n        if (currentPathPart == '.') {\n          return partialAbsPath;\n        }\n        if (currentPathPart == '..') {\n          return partialAbsPath.slice(0, -1)\n        }\n        return partialAbsPath.concat(currentPathPart);\n      },\n      []\n    ));\n  if (absCandidate === '' && rawPath.startsWith(PATH_SEPARATOR)) {\n    return PATH_SEPARATOR;\n  }\n  return absCandidate;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAAM,iBAAiB;AAEhB,MAAM,YAAY,IAAI,aAAuB,SAAS,OAAO,CAAC,KAAK,SAAS;AACjF,QAAM,OAAQ,IAAI,SAAS,cAAc,IAAK,IAAI,MAAM,GAAG,EAAE,IAAI;AACjE,QAAM,QAAS,KAAK,WAAW,cAAc,IAAK,KAAK,UAAU,CAAC,IAAI;AACtE,MAAI,QAAQ,QAAQ,gBAAgB;AAClC,WAAO,GAAG,IAAI,GAAG,cAAc,GAAG,KAAK;AAAA,EACzC;AACA,MAAI,KAAK,WAAW,cAAc,GAAG;AACnC,WAAO,GAAG,cAAc,GAAG,KAAK;AAAA,EAClC;AACA,SAAO;AACT,GAAG,EAAE;AAEE,MAAM,UAAU,CAAC,YAA4B;AAClD,QAAM,eAAe,UAAU;AAAA,IAC7B;AAAA,IACA,QAAQ,MAAM,cAAc,EAAE;AAAA,MAC5B,CAAC,gBAA0B,oBAA4B;AACrD,YAAI,mBAAmB,KAAK;AAC1B,iBAAO;AAAA,QACT;AACA,YAAI,mBAAmB,MAAM;AAC3B,iBAAO,eAAe,MAAM,GAAG,EAAE;AAAA,QACnC;AACA,eAAO,eAAe,OAAO,eAAe;AAAA,MAC9C;AAAA,MACA,CAAC;AAAA,IACH;AAAA,EAAC;AACH,MAAI,iBAAiB,MAAM,QAAQ,WAAW,cAAc,GAAG;AAC7D,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":[]}

package/dist/pathUtils.d.cts

@@ -0,0 +1,4 @@
+declare const joinPaths: (...pathPart: string[]) => string;
+declare const absPath: (rawPath: string) => string;
+
+export { absPath, joinPaths };

package/dist/pathUtils.d.ts

@@ -0,0 +1,4 @@
+declare const joinPaths: (...pathPart: string[]) => string;
+declare const absPath: (rawPath: string) => string;
+
+export { absPath, joinPaths };

package/dist/pathUtils.js

@@ -0,0 +1,38 @@
+const PATH_SEPARATOR = "/";
+const joinPaths = (...pathPart) => pathPart.reduce((acc, part) => {
+  const left = acc.endsWith(PATH_SEPARATOR) ? acc.slice(0, -1) : acc;
+  const right = part.startsWith(PATH_SEPARATOR) ? part.substring(1) : part;
+  if (left || acc === PATH_SEPARATOR) {
+    return `${left}${PATH_SEPARATOR}${right}`;
+  }
+  if (part.startsWith(PATH_SEPARATOR)) {
+    return `${PATH_SEPARATOR}${right}`;
+  }
+  return right;
+}, "");
+const absPath = (rawPath) => {
+  const absCandidate = joinPaths.apply(
+    null,
+    rawPath.split(PATH_SEPARATOR).reduce(
+      (partialAbsPath, currentPathPart) => {
+        if (currentPathPart == ".") {
+          return partialAbsPath;
+        }
+        if (currentPathPart == "..") {
+          return partialAbsPath.slice(0, -1);
+        }
+        return partialAbsPath.concat(currentPathPart);
+      },
+      []
+    )
+  );
+  if (absCandidate === "" && rawPath.startsWith(PATH_SEPARATOR)) {
+    return PATH_SEPARATOR;
+  }
+  return absCandidate;
+};
+export {
+  absPath,
+  joinPaths
+};
+//# sourceMappingURL=pathUtils.js.map

package/dist/pathUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pathUtils.ts"],"sourcesContent":["const PATH_SEPARATOR = \"/\";\n\nexport const joinPaths = (...pathPart: string[]) => pathPart.reduce((acc, part) => {\n  const left = (acc.endsWith(PATH_SEPARATOR)) ? acc.slice(0, -1) : acc;\n  const right = (part.startsWith(PATH_SEPARATOR)) ? part.substring(1) : part;\n  if (left || acc === PATH_SEPARATOR) {\n    return `${left}${PATH_SEPARATOR}${right}`;\n  }\n  if (part.startsWith(PATH_SEPARATOR)) {\n    return `${PATH_SEPARATOR}${right}`;\n  }\n  return right;\n}, \"\");\n\nexport const absPath = (rawPath: string): string => {\n  const absCandidate = joinPaths.apply(\n    null,\n    rawPath.split(PATH_SEPARATOR).reduce(\n      (partialAbsPath: string[], currentPathPart: string) => {\n        if (currentPathPart == '.') {\n          return partialAbsPath;\n        }\n        if (currentPathPart == '..') {\n          return partialAbsPath.slice(0, -1)\n        }\n        return partialAbsPath.concat(currentPathPart);\n      },\n      []\n    ));\n  if (absCandidate === '' && rawPath.startsWith(PATH_SEPARATOR)) {\n    return PATH_SEPARATOR;\n  }\n  return absCandidate;\n}\n"],"mappings":"AAAA,MAAM,iBAAiB;AAEhB,MAAM,YAAY,IAAI,aAAuB,SAAS,OAAO,CAAC,KAAK,SAAS;AACjF,QAAM,OAAQ,IAAI,SAAS,cAAc,IAAK,IAAI,MAAM,GAAG,EAAE,IAAI;AACjE,QAAM,QAAS,KAAK,WAAW,cAAc,IAAK,KAAK,UAAU,CAAC,IAAI;AACtE,MAAI,QAAQ,QAAQ,gBAAgB;AAClC,WAAO,GAAG,IAAI,GAAG,cAAc,GAAG,KAAK;AAAA,EACzC;AACA,MAAI,KAAK,WAAW,cAAc,GAAG;AACnC,WAAO,GAAG,cAAc,GAAG,KAAK;AAAA,EAClC;AACA,SAAO;AACT,GAAG,EAAE;AAEE,MAAM,UAAU,CAAC,YAA4B;AAClD,QAAM,eAAe,UAAU;AAAA,IAC7B;AAAA,IACA,QAAQ,MAAM,cAAc,EAAE;AAAA,MAC5B,CAAC,gBAA0B,oBAA4B;AACrD,YAAI,mBAAmB,KAAK;AAC1B,iBAAO;AAAA,QACT;AACA,YAAI,mBAAmB,MAAM;AAC3B,iBAAO,eAAe,MAAM,GAAG,EAAE;AAAA,QACnC;AACA,eAAO,eAAe,OAAO,eAAe;AAAA,MAC9C;AAAA,MACA,CAAC;AAAA,IACH;AAAA,EAAC;AACH,MAAI,iBAAiB,MAAM,QAAQ,WAAW,cAAc,GAAG;AAC7D,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":[]}

package/dist/routing.cjs

@@ -0,0 +1,84 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var routing_exports = {};
+__export(routing_exports, {
+  Router: () => Router,
+  applyRoutingRule: () => applyRoutingRule,
+  navigate: () => navigate,
+  useTinkerableLink: () => useTinkerableLink
+});
+module.exports = __toCommonJS(routing_exports);
+var import_react = require("react");
+var import_sandboxUtils = require("./sandboxUtils");
+var import_TinkerableContext = require("./TinkerableContext");
+var import_urlUtils = require("./urlUtils");
+var import_pathUtils = require("./pathUtils");
+const useTinkerableLink = (newSandboxLocation) => {
+  const { outerHref, navigationState: navigation } = (0, import_react.use)(import_TinkerableContext.TinkerableContext);
+  let newNavigationState = (0, import_urlUtils.parseTarget)(newSandboxLocation, navigation);
+  if (!(0, import_urlUtils.isAbsolutePath)(newSandboxLocation)) {
+    newNavigationState.sandboxPath = (0, import_pathUtils.joinPaths)(navigation.sandboxPath, newSandboxLocation);
+  } else {
+    newNavigationState.sandboxPath = newSandboxLocation;
+  }
+  return (0, import_urlUtils.constructUrl)(outerHref, newNavigationState);
+};
+const applyRoutingRule = (routingSpec, navigationState) => {
+  const { sandboxPath } = navigationState;
+  for (const routingRule of routingSpec.routes) {
+    if (typeof routingRule.pattern === "string") {
+      if (routingRule.pattern === sandboxPath) {
+        return { routingRule };
+      }
+    } else {
+      const match = sandboxPath.match(routingRule.pattern);
+      if (routingRule.pattern.test(sandboxPath)) {
+        return {
+          routingRule,
+          pathParameters: match?.groups
+        };
+      }
+    }
+  }
+  return void 0;
+};
+const Router = () => {
+  const context = (0, import_react.useContext)(import_TinkerableContext.TinkerableContext);
+  const { navigationState: { routingRule } } = context;
+  if (!routingRule) {
+    throw new Error(`No route registered for path ${context.navigationState.sandboxPath}!`);
+  }
+  return routingRule.reactNode;
+};
+const navigate = (target) => {
+  console.log(`[Sandbox] Navigating to ${target}`);
+  (0, import_sandboxUtils.sendMessage)("urlchange", {
+    url: target,
+    back: false,
+    forward: false
+  });
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Router,
+  applyRoutingRule,
+  navigate,
+  useTinkerableLink
+});
+//# sourceMappingURL=routing.cjs.map

package/dist/routing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/routing.tsx"],"sourcesContent":["import { use, useContext } from 'react';\n\nimport { sendMessage } from './sandboxUtils';\nimport { NavigationState, TinkerableContext } from './TinkerableContext';\nimport { RoutingRule, RoutingSpec } from './RoutingSpec';\nimport { constructUrl, isAbsolutePath, parseTarget } from './urlUtils';\nimport { joinPaths } from './pathUtils';\n\nexport type AppliedRoutingRule = {\n  routingRule: RoutingRule,\n  pathParameters?: Record<string, string>;\n}\n\nexport const useTinkerableLink = (newSandboxLocation: string) => {\n  const { outerHref, navigationState: navigation } = use(TinkerableContext);\n  let newNavigationState = parseTarget(newSandboxLocation, navigation);\n  if (!isAbsolutePath(newSandboxLocation)) {\n    newNavigationState.sandboxPath = joinPaths(navigation.sandboxPath, newSandboxLocation)\n  } else {\n    newNavigationState.sandboxPath = newSandboxLocation\n  }\n  return constructUrl(outerHref, newNavigationState);\n}\n\nexport const applyRoutingRule = (routingSpec:RoutingSpec, navigationState: NavigationState): AppliedRoutingRule | undefined => {\n  const { sandboxPath } = navigationState;\n  for (const routingRule of routingSpec.routes) {\n    if (typeof routingRule.pattern === 'string') {\n      if (routingRule.pattern === sandboxPath) {\n        return {routingRule};\n      }\n    } else {\n      const match = sandboxPath.match(routingRule.pattern);\n      if (routingRule.pattern.test(sandboxPath)) {\n        return {\n          routingRule,\n          pathParameters: match?.groups\n        }\n      }\n    }\n  }\n  return undefined;\n}\n\nexport const Router = () => {\n  const context = useContext(TinkerableContext);\n  const {navigationState: {routingRule}} = context;\n  if (!routingRule) {\n    // TODO: better error\n    throw new Error(`No route registered for path ${context.navigationState.sandboxPath}!`);\n  }\n\n  return routingRule.reactNode;\n};\n\n\n// Perform in-site navigation.\n// Top level frame is messaged to updated URL, after which a message will be\n// sent wit the new href, triggering the actual navigation.\nexport const navigate = (target: string) => {\n  console.log(`[Sandbox] Navigating to ${target}`)\n  sendMessage('urlchange', {\n    url: target,\n    back: false,\n    forward: false,\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAgC;AAEhC,0BAA4B;AAC5B,+BAAmD;AAEnD,sBAA0D;AAC1D,uBAA0B;AAOnB,MAAM,oBAAoB,CAAC,uBAA+B;AAC/D,QAAM,EAAE,WAAW,iBAAiB,WAAW,QAAI,kBAAI,0CAAiB;AACxE,MAAI,yBAAqB,6BAAY,oBAAoB,UAAU;AACnE,MAAI,KAAC,gCAAe,kBAAkB,GAAG;AACvC,uBAAmB,kBAAc,4BAAU,WAAW,aAAa,kBAAkB;AAAA,EACvF,OAAO;AACL,uBAAmB,cAAc;AAAA,EACnC;AACA,aAAO,8BAAa,WAAW,kBAAkB;AACnD;AAEO,MAAM,mBAAmB,CAAC,aAAyB,oBAAqE;AAC7H,QAAM,EAAE,YAAY,IAAI;AACxB,aAAW,eAAe,YAAY,QAAQ;AAC5C,QAAI,OAAO,YAAY,YAAY,UAAU;AAC3C,UAAI,YAAY,YAAY,aAAa;AACvC,eAAO,EAAC,YAAW;AAAA,MACrB;AAAA,IACF,OAAO;AACL,YAAM,QAAQ,YAAY,MAAM,YAAY,OAAO;AACnD,UAAI,YAAY,QAAQ,KAAK,WAAW,GAAG;AACzC,eAAO;AAAA,UACL;AAAA,UACA,gBAAgB,OAAO;AAAA,QACzB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEO,MAAM,SAAS,MAAM;AAC1B,QAAM,cAAU,yBAAW,0CAAiB;AAC5C,QAAM,EAAC,iBAAiB,EAAC,YAAW,EAAC,IAAI;AACzC,MAAI,CAAC,aAAa;AAEhB,UAAM,IAAI,MAAM,gCAAgC,QAAQ,gBAAgB,WAAW,GAAG;AAAA,EACxF;AAEA,SAAO,YAAY;AACrB;AAMO,MAAM,WAAW,CAAC,WAAmB;AAC1C,UAAQ,IAAI,2BAA2B,MAAM,EAAE;AAC/C,uCAAY,aAAa;AAAA,IACvB,KAAK;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,EACX,CAAC;AACH;","names":[]}

package/dist/routing.d.cts

@@ -0,0 +1,15 @@
+import * as react from 'react';
+import { NavigationState } from './TinkerableContext.cjs';
+import { RoutingRule, RoutingSpec } from './RoutingSpec.cjs';
+import './sandboxTypes.cjs';
+
+type AppliedRoutingRule = {
+    routingRule: RoutingRule;
+    pathParameters?: Record<string, string>;
+};
+declare const useTinkerableLink: (newSandboxLocation: string) => string;
+declare const applyRoutingRule: (routingSpec: RoutingSpec, navigationState: NavigationState) => AppliedRoutingRule | undefined;
+declare const Router: () => react.ReactNode;
+declare const navigate: (target: string) => void;
+
+export { type AppliedRoutingRule, Router, applyRoutingRule, navigate, useTinkerableLink };

package/dist/routing.d.ts

@@ -0,0 +1,15 @@
+import * as react from 'react';
+import { NavigationState } from './TinkerableContext.js';
+import { RoutingRule, RoutingSpec } from './RoutingSpec.js';
+import './sandboxTypes.js';
+
+type AppliedRoutingRule = {
+    routingRule: RoutingRule;
+    pathParameters?: Record<string, string>;
+};
+declare const useTinkerableLink: (newSandboxLocation: string) => string;
+declare const applyRoutingRule: (routingSpec: RoutingSpec, navigationState: NavigationState) => AppliedRoutingRule | undefined;
+declare const Router: () => react.ReactNode;
+declare const navigate: (target: string) => void;
+
+export { type AppliedRoutingRule, Router, applyRoutingRule, navigate, useTinkerableLink };

package/dist/routing.js

@@ -0,0 +1,57 @@
+import { use, useContext } from "react";
+import { sendMessage } from "./sandboxUtils";
+import { TinkerableContext } from "./TinkerableContext";
+import { constructUrl, isAbsolutePath, parseTarget } from "./urlUtils";
+import { joinPaths } from "./pathUtils";
+const useTinkerableLink = (newSandboxLocation) => {
+  const { outerHref, navigationState: navigation } = use(TinkerableContext);
+  let newNavigationState = parseTarget(newSandboxLocation, navigation);
+  if (!isAbsolutePath(newSandboxLocation)) {
+    newNavigationState.sandboxPath = joinPaths(navigation.sandboxPath, newSandboxLocation);
+  } else {
+    newNavigationState.sandboxPath = newSandboxLocation;
+  }
+  return constructUrl(outerHref, newNavigationState);
+};
+const applyRoutingRule = (routingSpec, navigationState) => {
+  const { sandboxPath } = navigationState;
+  for (const routingRule of routingSpec.routes) {
+    if (typeof routingRule.pattern === "string") {
+      if (routingRule.pattern === sandboxPath) {
+        return { routingRule };
+      }
+    } else {
+      const match = sandboxPath.match(routingRule.pattern);
+      if (routingRule.pattern.test(sandboxPath)) {
+        return {
+          routingRule,
+          pathParameters: match?.groups
+        };
+      }
+    }
+  }
+  return void 0;
+};
+const Router = () => {
+  const context = useContext(TinkerableContext);
+  const { navigationState: { routingRule } } = context;
+  if (!routingRule) {
+    throw new Error(`No route registered for path ${context.navigationState.sandboxPath}!`);
+  }
+  return routingRule.reactNode;
+};
+const navigate = (target) => {
+  console.log(`[Sandbox] Navigating to ${target}`);
+  sendMessage("urlchange", {
+    url: target,
+    back: false,
+    forward: false
+  });
+};
+export {
+  Router,
+  applyRoutingRule,
+  navigate,
+  useTinkerableLink
+};
+//# sourceMappingURL=routing.js.map

package/dist/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/routing.tsx"],"sourcesContent":["import { use, useContext } from 'react';\n\nimport { sendMessage } from './sandboxUtils';\nimport { NavigationState, TinkerableContext } from './TinkerableContext';\nimport { RoutingRule, RoutingSpec } from './RoutingSpec';\nimport { constructUrl, isAbsolutePath, parseTarget } from './urlUtils';\nimport { joinPaths } from './pathUtils';\n\nexport type AppliedRoutingRule = {\n  routingRule: RoutingRule,\n  pathParameters?: Record<string, string>;\n}\n\nexport const useTinkerableLink = (newSandboxLocation: string) => {\n  const { outerHref, navigationState: navigation } = use(TinkerableContext);\n  let newNavigationState = parseTarget(newSandboxLocation, navigation);\n  if (!isAbsolutePath(newSandboxLocation)) {\n    newNavigationState.sandboxPath = joinPaths(navigation.sandboxPath, newSandboxLocation)\n  } else {\n    newNavigationState.sandboxPath = newSandboxLocation\n  }\n  return constructUrl(outerHref, newNavigationState);\n}\n\nexport const applyRoutingRule = (routingSpec:RoutingSpec, navigationState: NavigationState): AppliedRoutingRule | undefined => {\n  const { sandboxPath } = navigationState;\n  for (const routingRule of routingSpec.routes) {\n    if (typeof routingRule.pattern === 'string') {\n      if (routingRule.pattern === sandboxPath) {\n        return {routingRule};\n      }\n    } else {\n      const match = sandboxPath.match(routingRule.pattern);\n      if (routingRule.pattern.test(sandboxPath)) {\n        return {\n          routingRule,\n          pathParameters: match?.groups\n        }\n      }\n    }\n  }\n  return undefined;\n}\n\nexport const Router = () => {\n  const context = useContext(TinkerableContext);\n  const {navigationState: {routingRule}} = context;\n  if (!routingRule) {\n    // TODO: better error\n    throw new Error(`No route registered for path ${context.navigationState.sandboxPath}!`);\n  }\n\n  return routingRule.reactNode;\n};\n\n\n// Perform in-site navigation.\n// Top level frame is messaged to updated URL, after which a message will be\n// sent wit the new href, triggering the actual navigation.\nexport const navigate = (target: string) => {\n  console.log(`[Sandbox] Navigating to ${target}`)\n  sendMessage('urlchange', {\n    url: target,\n    back: false,\n    forward: false,\n  });\n};\n"],"mappings":"AAAA,SAAS,KAAK,kBAAkB;AAEhC,SAAS,mBAAmB;AAC5B,SAA0B,yBAAyB;AAEnD,SAAS,cAAc,gBAAgB,mBAAmB;AAC1D,SAAS,iBAAiB;AAOnB,MAAM,oBAAoB,CAAC,uBAA+B;AAC/D,QAAM,EAAE,WAAW,iBAAiB,WAAW,IAAI,IAAI,iBAAiB;AACxE,MAAI,qBAAqB,YAAY,oBAAoB,UAAU;AACnE,MAAI,CAAC,eAAe,kBAAkB,GAAG;AACvC,uBAAmB,cAAc,UAAU,WAAW,aAAa,kBAAkB;AAAA,EACvF,OAAO;AACL,uBAAmB,cAAc;AAAA,EACnC;AACA,SAAO,aAAa,WAAW,kBAAkB;AACnD;AAEO,MAAM,mBAAmB,CAAC,aAAyB,oBAAqE;AAC7H,QAAM,EAAE,YAAY,IAAI;AACxB,aAAW,eAAe,YAAY,QAAQ;AAC5C,QAAI,OAAO,YAAY,YAAY,UAAU;AAC3C,UAAI,YAAY,YAAY,aAAa;AACvC,eAAO,EAAC,YAAW;AAAA,MACrB;AAAA,IACF,OAAO;AACL,YAAM,QAAQ,YAAY,MAAM,YAAY,OAAO;AACnD,UAAI,YAAY,QAAQ,KAAK,WAAW,GAAG;AACzC,eAAO;AAAA,UACL;AAAA,UACA,gBAAgB,OAAO;AAAA,QACzB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEO,MAAM,SAAS,MAAM;AAC1B,QAAM,UAAU,WAAW,iBAAiB;AAC5C,QAAM,EAAC,iBAAiB,EAAC,YAAW,EAAC,IAAI;AACzC,MAAI,CAAC,aAAa;AAEhB,UAAM,IAAI,MAAM,gCAAgC,QAAQ,gBAAgB,WAAW,GAAG;AAAA,EACxF;AAEA,SAAO,YAAY;AACrB;AAMO,MAAM,WAAW,CAAC,WAAmB;AAC1C,UAAQ,IAAI,2BAA2B,MAAM,EAAE;AAC/C,cAAY,aAAa;AAAA,IACvB,KAAK;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,EACX,CAAC;AACH;","names":[]}

package/dist/sandboxTypes.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var sandboxTypes_exports = {};
+module.exports = __toCommonJS(sandboxTypes_exports);
+//# sourceMappingURL=sandboxTypes.cjs.map

package/dist/sandboxTypes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sandboxTypes.ts"],"sourcesContent":["export type ModuleExports = any\n\n// The real type is EvaluationContext from src/bundler/module/Evaluation.ts:6\nexport type EvaluationContext = {\n  exports: ModuleExports;\n  dynamicImport: (moduleToImport: string, symbolToImport:string) => Promise<ModuleExports>;\n  getModuleEvaluationContext: (moduleName: string) =>  Promise<EvaluationContext>;\n  resolve: (moduleName: string) => Promise<string>;\n  evaluation: {\n    module: {\n      source: string;\n      filepath: string;\n    }\n  }\n}\n\nexport type Metadata = Record<string, any>;\nexport type FilesMetadata = Record<string, Metadata>;\nexport type FileQueryResult = string[]\nexport type MetadataQueryFunction = (filesMetadata:FilesMetadata) => FileQueryResult;\nexport type MetadataQueryResult = {result: FileQueryResult} | {error: any}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/sandboxTypes.d.cts

@@ -0,0 +1,24 @@
+type ModuleExports = any;
+type EvaluationContext = {
+    exports: ModuleExports;
+    dynamicImport: (moduleToImport: string, symbolToImport: string) => Promise<ModuleExports>;
+    getModuleEvaluationContext: (moduleName: string) => Promise<EvaluationContext>;
+    resolve: (moduleName: string) => Promise<string>;
+    evaluation: {
+        module: {
+            source: string;
+            filepath: string;
+        };
+    };
+};
+type Metadata = Record<string, any>;
+type FilesMetadata = Record<string, Metadata>;
+type FileQueryResult = string[];
+type MetadataQueryFunction = (filesMetadata: FilesMetadata) => FileQueryResult;
+type MetadataQueryResult = {
+    result: FileQueryResult;
+} | {
+    error: any;
+};
+
+export type { EvaluationContext, FileQueryResult, FilesMetadata, Metadata, MetadataQueryFunction, MetadataQueryResult, ModuleExports };

package/dist/sandboxTypes.d.ts

@@ -0,0 +1,24 @@
+type ModuleExports = any;
+type EvaluationContext = {
+    exports: ModuleExports;
+    dynamicImport: (moduleToImport: string, symbolToImport: string) => Promise<ModuleExports>;
+    getModuleEvaluationContext: (moduleName: string) => Promise<EvaluationContext>;
+    resolve: (moduleName: string) => Promise<string>;
+    evaluation: {
+        module: {
+            source: string;
+            filepath: string;
+        };
+    };
+};
+type Metadata = Record<string, any>;
+type FilesMetadata = Record<string, Metadata>;
+type FileQueryResult = string[];
+type MetadataQueryFunction = (filesMetadata: FilesMetadata) => FileQueryResult;
+type MetadataQueryResult = {
+    result: FileQueryResult;
+} | {
+    error: any;
+};
+
+export type { EvaluationContext, FileQueryResult, FilesMetadata, Metadata, MetadataQueryFunction, MetadataQueryResult, ModuleExports };

package/dist/sandboxTypes.js

@@ -0,0 +1 @@
+//# sourceMappingURL=sandboxTypes.js.map

package/dist/sandboxTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/sandboxUtils.cjs

@@ -0,0 +1,46 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var sandboxUtils_exports = {};
+__export(sandboxUtils_exports, {
+  addListener: () => addListener,
+  protocolRequest: () => protocolRequest,
+  sendMessage: () => sendMessage
+});
+module.exports = __toCommonJS(sandboxUtils_exports);
+const sendMessage = (type, data = {}) => {
+  module.evaluation.module.bundler.messageBus.sendMessage(type, data);
+};
+const protocolRequest = (protocolName, method, params) => {
+  return module.evaluation.module.bundler.messageBus.protocolRequest(protocolName, method, params);
+};
+const addListener = (msgType, handler, event) => {
+  const disposable = (event ?? module.evaluation.module.bundler.messageBus.onMessage)((msg) => {
+    if (msg.type === msgType) {
+      handler(msg);
+    }
+  });
+  return () => disposable.dispose();
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addListener,
+  protocolRequest,
+  sendMessage
+});
+//# sourceMappingURL=sandboxUtils.cjs.map

package/dist/sandboxUtils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sandboxUtils.ts"],"sourcesContent":["export const sendMessage = (type: string, data: Record<string, any> = {}) => {\n  // module.evaluation is defined in the sandbox environment\n  // @ts-ignore\n  module.evaluation.module.bundler.messageBus.sendMessage(type, data);\n}\n\nexport const protocolRequest = (protocolName: string, method: string, params: Array<any>): Promise<any> => {\n  // example usage: const response = await protocolRequest('fs', 'readFile', [path]);\n  // module.evaluation is defined in the sandbox environment\n  // @ts-ignore\n  return module.evaluation.module.bundler.messageBus.protocolRequest(protocolName, method, params);\n}\n\nexport const addListener = (msgType: string, handler: (msg:any)=>void, event?:any):(() => void) => {\n  // @ts-ignore\n  const disposable = (event ?? module.evaluation.module.bundler.messageBus.onMessage)((msg) => {\n    if (msg.type === msgType) {\n      handler(msg);\n    }\n  });\n  return () => disposable.dispose();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,cAAc,CAAC,MAAc,OAA4B,CAAC,MAAM;AAG3E,SAAO,WAAW,OAAO,QAAQ,WAAW,YAAY,MAAM,IAAI;AACpE;AAEO,MAAM,kBAAkB,CAAC,cAAsB,QAAgB,WAAqC;AAIzG,SAAO,OAAO,WAAW,OAAO,QAAQ,WAAW,gBAAgB,cAAc,QAAQ,MAAM;AACjG;AAEO,MAAM,cAAc,CAAC,SAAiB,SAA0B,UAA4B;AAEjG,QAAM,cAAc,SAAS,OAAO,WAAW,OAAO,QAAQ,WAAW,WAAW,CAAC,QAAQ;AAC3F,QAAI,IAAI,SAAS,SAAS;AACxB,cAAQ,GAAG;AAAA,IACb;AAAA,EACF,CAAC;AACD,SAAO,MAAM,WAAW,QAAQ;AAClC;","names":[]}

package/dist/sandboxUtils.d.cts

@@ -0,0 +1,5 @@
+declare const sendMessage: (type: string, data?: Record<string, any>) => void;
+declare const protocolRequest: (protocolName: string, method: string, params: Array<any>) => Promise<any>;
+declare const addListener: (msgType: string, handler: (msg: any) => void, event?: any) => (() => void);
+
+export { addListener, protocolRequest, sendMessage };

package/dist/sandboxUtils.d.ts

@@ -0,0 +1,5 @@
+declare const sendMessage: (type: string, data?: Record<string, any>) => void;
+declare const protocolRequest: (protocolName: string, method: string, params: Array<any>) => Promise<any>;
+declare const addListener: (msgType: string, handler: (msg: any) => void, event?: any) => (() => void);
+
+export { addListener, protocolRequest, sendMessage };

package/dist/sandboxUtils.js

@@ -0,0 +1,20 @@
+const sendMessage = (type, data = {}) => {
+  module.evaluation.module.bundler.messageBus.sendMessage(type, data);
+};
+const protocolRequest = (protocolName, method, params) => {
+  return module.evaluation.module.bundler.messageBus.protocolRequest(protocolName, method, params);
+};
+const addListener = (msgType, handler, event) => {
+  const disposable = (event ?? module.evaluation.module.bundler.messageBus.onMessage)((msg) => {
+    if (msg.type === msgType) {
+      handler(msg);
+    }
+  });
+  return () => disposable.dispose();
+};
+export {
+  addListener,
+  protocolRequest,
+  sendMessage
+};
+//# sourceMappingURL=sandboxUtils.js.map

package/dist/sandboxUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sandboxUtils.ts"],"sourcesContent":["export const sendMessage = (type: string, data: Record<string, any> = {}) => {\n  // module.evaluation is defined in the sandbox environment\n  // @ts-ignore\n  module.evaluation.module.bundler.messageBus.sendMessage(type, data);\n}\n\nexport const protocolRequest = (protocolName: string, method: string, params: Array<any>): Promise<any> => {\n  // example usage: const response = await protocolRequest('fs', 'readFile', [path]);\n  // module.evaluation is defined in the sandbox environment\n  // @ts-ignore\n  return module.evaluation.module.bundler.messageBus.protocolRequest(protocolName, method, params);\n}\n\nexport const addListener = (msgType: string, handler: (msg:any)=>void, event?:any):(() => void) => {\n  // @ts-ignore\n  const disposable = (event ?? module.evaluation.module.bundler.messageBus.onMessage)((msg) => {\n    if (msg.type === msgType) {\n      handler(msg);\n    }\n  });\n  return () => disposable.dispose();\n}\n"],"mappings":"AAAO,MAAM,cAAc,CAAC,MAAc,OAA4B,CAAC,MAAM;AAG3E,SAAO,WAAW,OAAO,QAAQ,WAAW,YAAY,MAAM,IAAI;AACpE;AAEO,MAAM,kBAAkB,CAAC,cAAsB,QAAgB,WAAqC;AAIzG,SAAO,OAAO,WAAW,OAAO,QAAQ,WAAW,gBAAgB,cAAc,QAAQ,MAAM;AACjG;AAEO,MAAM,cAAc,CAAC,SAAiB,SAA0B,UAA4B;AAEjG,QAAM,cAAc,SAAS,OAAO,WAAW,OAAO,QAAQ,WAAW,WAAW,CAAC,QAAQ;AAC3F,QAAI,IAAI,SAAS,SAAS;AACxB,cAAQ,GAAG;AAAA,IACb;AAAA,EACF,CAAC;AACD,SAAO,MAAM,WAAW,QAAQ;AAClC;","names":[]}