@adobe/uix-core 0.6.3

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/debuglog.ts","../../src/debug-emitter.ts","../../src/emitter.ts","../../src/namespace-proxy.ts","../../src/timeout-promise.ts"],"names":["target"],"mappings":"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","sourcesContent":["/*\nCopyright 2022 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\n/**\n * Fancy looking console decorator.\n * @hidden\n * @internal\n */\n\n/** @internal */\nconst isDarkMode = () =>\n  typeof window.matchMedia === \"function\" &&\n  window.matchMedia(\"(prefers-color-scheme: dark)\").matches;\n\n/** @internal */\ntype Layout = {\n  padX: number;\n  padY: number;\n  rounded: number;\n  fontSize: number;\n  emphasis: Style;\n};\n/** @internal */\ntype HexColor = `#${string}` | \"transparent\";\n/** @internal */\ntype Color = {\n  text: HexColor;\n  bg: HexColor;\n  hilight: HexColor;\n  shadow: HexColor;\n};\n/** @internal */\ntype ThemeSpec = Color & Layout;\n\n/** @internal */\nconst Layouts: Record<string, Layout> = {\n  medium: {\n    padX: 5,\n    padY: 3,\n    rounded: 4,\n    fontSize: 100,\n    emphasis: \"font-weight: bold;\",\n  },\n  small: {\n    padX: 3,\n    padY: 1,\n    rounded: 2,\n    fontSize: 95,\n    emphasis: \"font-style: italic;\",\n  },\n};\n\n/** @internal */\nconst Colors: Record<string, Color> = {\n  yellow: {\n    text: \"#333333\",\n    bg: \"#EBD932\",\n    hilight: \"#F7E434\",\n    shadow: \"#D1C12C\",\n  },\n  green: {\n    text: \"#333333\",\n    bg: \"#96EB5E\",\n    hilight: \"#9EF763\",\n    shadow: \"#85D154\",\n  },\n  blue: {\n    text: \"#333333\",\n    bg: \"#8DD0EB\",\n    hilight: \"#88F0F7\",\n    shadow: \"#74AED4\",\n  },\n  gray: isDarkMode()\n    ? {\n        text: \"#eeeeee\",\n        bg: \"transparent\",\n        hilight: \"#cecece\",\n        shadow: \"#cecece\",\n      }\n    : {\n        text: \"#333333\",\n        bg: \"#eeeeee\",\n        hilight: \"#f6f6f6\",\n        shadow: \"#cecece\",\n      },\n};\n\n/** @internal */\ntype ThemeTag = `${keyof typeof Colors} ${keyof typeof Layouts}`;\n\n/**\n * @internal\n */\nexport type Theme = ThemeSpec | ThemeTag;\n\n/** @internal */\ntype LogDecorator = (...args: unknown[]) => unknown[];\n\n/** @internal */\ntype Style = `${string};`;\n\nfunction memoizeUnary<T, U>(fn: (arg: T) => U): typeof fn {\n  const cache: Map<T, U> = new Map();\n  return (arg) => {\n    if (!cache.has(arg)) {\n      const result = fn(arg);\n      cache.set(arg, result);\n      if (cache.size > 100) {\n        cache.delete(cache.keys().next().value as T);\n      }\n      return result;\n    }\n    return cache.get(arg);\n  };\n}\n\nconst toTheme = memoizeUnary((theme: Theme): ThemeSpec => {\n  if (typeof theme === \"string\") {\n    const [color, size] = theme.split(\" \");\n    return {\n      ...Colors[color],\n      ...Layouts[size],\n    };\n  }\n  return theme;\n});\n\nconst block: Style = `display: inline-block; border: 1px solid;`;\n\nconst flatten = (side: \"left\" | \"right\"): Style =>\n  `padding-${side}: 0px; border-${side}-width: 0px; border-top-${side}-radius: 0px; border-bottom-${side}-radius: 0px;`;\n\nconst toColor = ({ bg, hilight, shadow, text }: Color): Style =>\n  `color: ${text}; background: ${bg}; border-color: ${hilight} ${shadow} ${shadow} ${hilight};`;\n\nconst toLayout = ({ fontSize, padY, padX, rounded }: Layout) =>\n  `font-size: ${fontSize}%; padding: ${padY}px ${padX}px; border-radius: ${rounded}px;`;\n\nconst toBubbleStyle = memoizeUnary((theme: ThemeSpec): string[] => {\n  const base = `${block}${toColor(theme)}${toLayout(theme)}`;\n  return [\n    `${base}${flatten(\"right\")}`,\n    `${base}${flatten(\"left\")}${theme.emphasis}`,\n  ] as Style[];\n});\n\nfunction toBubblePrepender(\n  bubbleLeft: string,\n  bubbleRight: string,\n  theme: ThemeSpec\n): LogDecorator {\n  const prefix = `%c${bubbleLeft}%c ${bubbleRight}`;\n  const [left, right] = toBubbleStyle(theme);\n  return (args: unknown[]) => {\n    const bubbleArgs = [prefix, left, right];\n    if (typeof args[0] === \"string\") {\n      bubbleArgs[0] = `${prefix}%c ${args.shift() as string}`;\n      bubbleArgs.push(\"\"); // reset style\n    }\n    return [...bubbleArgs, ...args];\n  };\n}\n\n/** @internal */\nconst stateTypes = {\n  event: \"️⚡️\",\n} as const;\n\nconst stateDelim = \" ⤻ \";\n\n/** @internal */\ntype DebugState = { type: keyof typeof stateTypes; name: string };\n\n// Serialize to memoize.\nconst getStateFormatter = memoizeUnary((stateJson: string) => {\n  const stateStack = JSON.parse(stateJson) as unknown as DebugState[];\n  const firstState = stateStack.shift();\n  const left = stateTypes[firstState.type];\n  const right = [\n    firstState.name,\n    ...stateStack.map((state) => `${stateTypes[state.type]} ${state.name}`),\n  ].join(stateDelim);\n  return toBubblePrepender(left, right, toTheme(\"gray small\"));\n});\nconst getStatePrepender = (stateStack: DebugState[]) =>\n  getStateFormatter(JSON.stringify(stateStack));\n\nconst overrideMethods = [\"log\", \"error\", \"warn\", \"info\", \"debug\"] as const;\n\nconst identity = <T>(x: T) => x;\n\nconst noop = (): (() => undefined) => undefined;\n\n/**\n * A console, plus some methods to track event lifecycles.\n * @internal\n */\nexport interface DebugLogger extends Console {\n  /**\n   * Stop all logging; methods do nothing\n   * @internal\n   */\n  detach(): void;\n  /**\n   * Add an event bubble to the log during handler.\n   */\n  pushState(state: DebugState): void;\n  /**\n   * Remove the bubble when event is done dispatching\n   */\n  popState(): void;\n}\n\n/**\n * Returns a console whose methods autoformat with bubbles.\n * @internal\n */\nexport function _customConsole(\n  theme: Theme,\n  type: string,\n  name: string\n): DebugLogger {\n  const prepender = toBubblePrepender(`X${type}`, name, toTheme(theme));\n  let statePrepender: LogDecorator = identity as LogDecorator;\n  const stateStack: DebugState[] = [];\n  const loggerProto: PropertyDescriptorMap = {\n    detach: {\n      writable: true,\n      configurable: true,\n      value(this: DebugLogger) {\n        overrideMethods.forEach((method) => {\n          this[method] = noop;\n        });\n      },\n    },\n    pushState: {\n      value(state: DebugState) {\n        stateStack.push(state);\n        statePrepender = getStatePrepender(stateStack);\n      },\n    },\n    popState: {\n      value() {\n        stateStack.pop();\n        statePrepender =\n          stateStack.length === 0\n            ? (identity as LogDecorator)\n            : getStatePrepender(stateStack);\n      },\n    },\n  };\n  const customConsole = Object.create(\n    console,\n    overrideMethods.reduce((out, level) => {\n      out[level] = {\n        writable: true,\n        configurable: true,\n        value(...args: unknown[]) {\n          console[level](...prepender(statePrepender(args)));\n        },\n      };\n      return out;\n    }, loggerProto)\n  ) as DebugLogger;\n  return customConsole;\n}\n\n/**\n * @internal\n */\nexport const quietConsole = new Proxy(console, {\n  get() {\n    return noop;\n  },\n});\n","/*\nCopyright 2022 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\nimport { _customConsole, DebugLogger, Theme } from \"./debuglog.js\";\nimport { Emits, Unsubscriber } from \"./types.js\";\n\n/**\n * Adds methods for logging events\n * @internal\n */\nexport interface EmitterDebugLogger extends DebugLogger {\n  /**\n   * Listen to an event and pass the logger to the handler\n   * @internal\n   */\n  listen(\n    type: string,\n    listener: (logger: EmitterDebugLogger, ev: CustomEvent) => unknown\n  ): this;\n}\n\n/**\n * Debugger for EventTarget objects like Hosts, Ports and Guests, which\n * patches dispatchEvent to log events\n * Adapter to attach console logging listeners to all events on an emitter.\n * @internal\n */\nexport function debugEmitter(\n  emitter: Emits,\n  opts: {\n    theme: Theme;\n    type?: string;\n    id?: string;\n  }\n): EmitterDebugLogger {\n  const logger = _customConsole(\n    opts.theme,\n    opts.type ||\n      (Object.getPrototypeOf(emitter) as typeof emitter).constructor.name,\n    opts.id || emitter.id\n  ) as EmitterDebugLogger;\n  const oldDispatch = emitter.dispatchEvent;\n  emitter.dispatchEvent = (event) => {\n    logger.pushState({ type: \"event\", name: event.type });\n    const retVal = oldDispatch.call(emitter, event) as boolean;\n    logger.popState();\n    return retVal;\n  };\n\n  const subscriptions: Unsubscriber[] = [];\n\n  const oldDetach = logger.detach;\n  logger.detach = () => {\n    oldDetach.call(logger);\n    subscriptions.forEach((unsubscribe) => unsubscribe());\n  };\n\n  /**\n   * Listens and passes a logger to callbacks\n   */\n  function listen(\n    type: string,\n    listener: (logger: EmitterDebugLogger, ev: CustomEvent) => unknown\n  ) {\n    subscriptions.push(\n      emitter.addEventListener(type, (event) => listener(logger, event))\n    );\n    return logger;\n  }\n\n  logger.listen = listen;\n\n  return logger;\n}\n","/*\nCopyright 2022 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\nimport { Emits, Unsubscriber, NamedEvent } from \"./types.js\";\n\n/**\n * Browser-native {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget | EventTarget}\n * whose {@link Emitter.addEventListener} method returns an anonymous function\n * which unsubscribes the original handler.\n *\n * Also provides typed events via generics. You can create or extend this class\n * to define custom emitters with known event names and signatures.\n *\n * @example\n * ```ts\n * import type { NamedEvent, Emitter } from '@adobe/uix-sdk'\n *\n * class FizzBuzzEmitter extends Emitter<\n *   NamedEvent<\"fizz\", { fizzCount: number }> |\n *   NamedEvent<\"buzz\", { buzzCount: number }> |\n *   NamedEvent<\"fizzbuzz\">\n * > {\n * }\n * ```\n * The `FizzBuzzEmitter` class will now type check its events and event\n * listeners, providing autosuggest in editors.\n *\n * @see [EventTarget - MDN](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget)\n *\n * @public\n */\nexport class Emitter<Events extends NamedEvent>\n  extends EventTarget\n  implements Emits<Events>\n{\n  /**\n   * An arbitrary string to uniquely identify this emitter and its events.\n   * @public\n   */\n  id: string;\n  constructor(id: string) {\n    super();\n    this.id = id;\n  }\n  /**\n   * Convenience method to construct and dispatch custom events.\n   *\n   * @param type - Name of one of the allowed events this can emit\n   * @param detail - Object to expose in the {@link https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent/detail | CustomEvent#detail}\n   * property.\n   * @public\n   */\n  protected emit<Event extends Events>(\n    type: Event[\"type\"],\n    detail: Event[\"detail\"]\n  ): void {\n    const event = new CustomEvent<typeof detail>(type, { detail });\n    this.dispatchEvent(event);\n  }\n  /**\n   * Subscribe to an event and receive an unsubscribe callback.\n   * @see [EventTarget.addEventListener - MDN](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener)\n   *\n   * Identical to `EventTarget.addEventListener`, but returns an \"unsubscriber\"\n   * function which detaches the listener when invoked. Solves an ergonomic\n   * problem with native EventTargets where it's impossible to detach listeners\n   * without having a reference to the original handler.\n   *\n   * @typeParam E - Name of one of the allowed events this can emit\n   * @param type - Event type\n   * @param listener - Event handler\n   * @returns Call to unsubscribe listener.\n   */\n  addEventListener<\n    Type extends Events[\"type\"],\n    Event extends Extract<Events, { type: Type }>\n  >(type: Type, listener: (ev: Event) => unknown): Unsubscriber {\n    super.addEventListener(type, listener);\n    return () => super.removeEventListener(type, listener);\n  }\n}\n","/*\nCopyright 2022 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { RemoteHostApis, RemoteMethodInvoker } from \"./types.js\";\n\n/**\n * Build a fake object that turns \"method calls\" into RPC messages\n * The resulting object will recursively make more fake proxies on demand until\n * one of the looked-up properties is invoked as a function.\n * Then it will call the passed `invoke` method with a {@link HostMethodAddress}\n * that can send the method invocation as an RPC message to another realm.\n *\n * @example\n * ```js\n * const invoker = (methodAddress) => console.log(\n *   address.path,\n *   address.name,\n *   address.args\n * );\n * const ns = makeNamespaceProxy(invoker);\n *\n * // looking up any property on the object will work\n *\n * ns.example.builds.method.call.message(\"foo\", 1);\n *\n * // Console will log:\n * ['example','builds','method','call']\n * 'message'\n * [\"foo\", 1]\n *```\n * @internal\n *\n * @param invoke - Callback that receives address\n */\nexport function makeNamespaceProxy<ProxiedApi extends object>(\n  invoke: RemoteMethodInvoker<unknown>,\n  path: string[] = []\n): RemoteHostApis<ProxiedApi> {\n  const handler: ProxyHandler<Record<string, any>> = {\n    get: (target, prop) => {\n      if (typeof prop === \"string\") {\n        if (!Reflect.has(target, prop)) {\n          const next = makeNamespaceProxy(invoke, path.concat(prop));\n          Reflect.set(target, prop, next);\n        }\n        return Reflect.get(target, prop) as unknown;\n      } else {\n        throw new Error(\n          `Cannot look up a symbol ${String(prop)} on a host connection proxy.`\n        );\n      }\n    },\n  };\n  const target = {} as unknown as RemoteHostApis<ProxiedApi>;\n  // Only trap the apply if there's at least two levels of namespace.\n  // uix.host() is not a function, and neither is uix.host.bareMethod().\n  if (path.length < 2) {\n    return new Proxy<RemoteHostApis<ProxiedApi>>(target, handler);\n  }\n  const invoker = (...args: unknown[]) =>\n    invoke({\n      path: path.slice(0, -1),\n      name: path[path.length - 1],\n      args,\n    });\n  return new Proxy<typeof invoker>(invoker, {\n    ...handler,\n    apply(target, _, args: unknown[]) {\n      return target(...args);\n    },\n  }) as unknown as typeof target;\n}\n","/*\nCopyright 2022 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\n/**\n * Add a timeout to a Promise. The returned Promise will resolve to the value of\n * the original Promise, but if it doesn't resolve within the timeout interval,\n * it will reject with a timeout error.\n * @internal\n *\n * @param timeoutMs - Time to wait (ms) before rejecting\n * @param promise - Original promise to set a timeout for\n * @returns - Promise that rejects after X milliseconds have passed\n */\nexport function timeoutPromise<T>(timeoutMs: number, promise: Promise<T>) {\n  return new Promise((resolve, reject) => {\n    const timeout = setTimeout(\n      () => reject(new Error(`Timed out after ${timeoutMs}ms`)),\n      timeoutMs\n    );\n    promise\n      .then((result) => {\n        clearTimeout(timeout);\n        resolve(result);\n      })\n      .catch(reject);\n  });\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Core utilities, types and contracts for the Adobe UIX SDK.
+ * @packageDocumentation
+ */
+export * from "./debug-emitter";
+export * from "./debuglog";
+export * from "./emitter";
+export * from "./namespace-proxy";
+export * from "./timeout-promise";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA;;;GAGG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,266 @@
+'use strict';
+
+// src/debuglog.ts
+var isDarkMode = () => typeof window.matchMedia === "function" && window.matchMedia("(prefers-color-scheme: dark)").matches;
+var Layouts = {
+  medium: {
+    padX: 5,
+    padY: 3,
+    rounded: 4,
+    fontSize: 100,
+    emphasis: "font-weight: bold;"
+  },
+  small: {
+    padX: 3,
+    padY: 1,
+    rounded: 2,
+    fontSize: 95,
+    emphasis: "font-style: italic;"
+  }
+};
+var Colors = {
+  yellow: {
+    text: "#333333",
+    bg: "#EBD932",
+    hilight: "#F7E434",
+    shadow: "#D1C12C"
+  },
+  green: {
+    text: "#333333",
+    bg: "#96EB5E",
+    hilight: "#9EF763",
+    shadow: "#85D154"
+  },
+  blue: {
+    text: "#333333",
+    bg: "#8DD0EB",
+    hilight: "#88F0F7",
+    shadow: "#74AED4"
+  },
+  gray: isDarkMode() ? {
+    text: "#eeeeee",
+    bg: "transparent",
+    hilight: "#cecece",
+    shadow: "#cecece"
+  } : {
+    text: "#333333",
+    bg: "#eeeeee",
+    hilight: "#f6f6f6",
+    shadow: "#cecece"
+  }
+};
+function memoizeUnary(fn) {
+  const cache = /* @__PURE__ */ new Map();
+  return (arg) => {
+    if (!cache.has(arg)) {
+      const result = fn(arg);
+      cache.set(arg, result);
+      if (cache.size > 100) {
+        cache.delete(cache.keys().next().value);
+      }
+      return result;
+    }
+    return cache.get(arg);
+  };
+}
+var toTheme = memoizeUnary((theme) => {
+  if (typeof theme === "string") {
+    const [color, size] = theme.split(" ");
+    return {
+      ...Colors[color],
+      ...Layouts[size]
+    };
+  }
+  return theme;
+});
+var block = `display: inline-block; border: 1px solid;`;
+var flatten = (side) => `padding-${side}: 0px; border-${side}-width: 0px; border-top-${side}-radius: 0px; border-bottom-${side}-radius: 0px;`;
+var toColor = ({ bg, hilight, shadow, text }) => `color: ${text}; background: ${bg}; border-color: ${hilight} ${shadow} ${shadow} ${hilight};`;
+var toLayout = ({ fontSize, padY, padX, rounded }) => `font-size: ${fontSize}%; padding: ${padY}px ${padX}px; border-radius: ${rounded}px;`;
+var toBubbleStyle = memoizeUnary((theme) => {
+  const base = `${block}${toColor(theme)}${toLayout(theme)}`;
+  return [
+    `${base}${flatten("right")}`,
+    `${base}${flatten("left")}${theme.emphasis}`
+  ];
+});
+function toBubblePrepender(bubbleLeft, bubbleRight, theme) {
+  const prefix = `%c${bubbleLeft}%c ${bubbleRight}`;
+  const [left, right] = toBubbleStyle(theme);
+  return (args) => {
+    const bubbleArgs = [prefix, left, right];
+    if (typeof args[0] === "string") {
+      bubbleArgs[0] = `${prefix}%c ${args.shift()}`;
+      bubbleArgs.push("");
+    }
+    return [...bubbleArgs, ...args];
+  };
+}
+var stateTypes = {
+  event: "\uFE0F\u26A1\uFE0F"
+};
+var stateDelim = " \u293B ";
+var getStateFormatter = memoizeUnary((stateJson) => {
+  const stateStack = JSON.parse(stateJson);
+  const firstState = stateStack.shift();
+  const left = stateTypes[firstState.type];
+  const right = [
+    firstState.name,
+    ...stateStack.map((state) => `${stateTypes[state.type]} ${state.name}`)
+  ].join(stateDelim);
+  return toBubblePrepender(left, right, toTheme("gray small"));
+});
+var getStatePrepender = (stateStack) => getStateFormatter(JSON.stringify(stateStack));
+var overrideMethods = ["log", "error", "warn", "info", "debug"];
+var identity = (x) => x;
+var noop = () => void 0;
+function _customConsole(theme, type, name) {
+  const prepender = toBubblePrepender(`X${type}`, name, toTheme(theme));
+  let statePrepender = identity;
+  const stateStack = [];
+  const loggerProto = {
+    detach: {
+      writable: true,
+      configurable: true,
+      value() {
+        overrideMethods.forEach((method) => {
+          this[method] = noop;
+        });
+      }
+    },
+    pushState: {
+      value(state) {
+        stateStack.push(state);
+        statePrepender = getStatePrepender(stateStack);
+      }
+    },
+    popState: {
+      value() {
+        stateStack.pop();
+        statePrepender = stateStack.length === 0 ? identity : getStatePrepender(stateStack);
+      }
+    }
+  };
+  const customConsole = Object.create(
+    console,
+    overrideMethods.reduce((out, level) => {
+      out[level] = {
+        writable: true,
+        configurable: true,
+        value(...args) {
+          console[level](...prepender(statePrepender(args)));
+        }
+      };
+      return out;
+    }, loggerProto)
+  );
+  return customConsole;
+}
+var quietConsole = new Proxy(console, {
+  get() {
+    return noop;
+  }
+});
+
+// src/debug-emitter.ts
+function debugEmitter(emitter, opts) {
+  const logger = _customConsole(
+    opts.theme,
+    opts.type || Object.getPrototypeOf(emitter).constructor.name,
+    opts.id || emitter.id
+  );
+  const oldDispatch = emitter.dispatchEvent;
+  emitter.dispatchEvent = (event) => {
+    logger.pushState({ type: "event", name: event.type });
+    const retVal = oldDispatch.call(emitter, event);
+    logger.popState();
+    return retVal;
+  };
+  const subscriptions = [];
+  const oldDetach = logger.detach;
+  logger.detach = () => {
+    oldDetach.call(logger);
+    subscriptions.forEach((unsubscribe) => unsubscribe());
+  };
+  function listen(type, listener) {
+    subscriptions.push(
+      emitter.addEventListener(type, (event) => listener(logger, event))
+    );
+    return logger;
+  }
+  logger.listen = listen;
+  return logger;
+}
+
+// src/emitter.ts
+var Emitter = class extends EventTarget {
+  constructor(id) {
+    super();
+    this.id = id;
+  }
+  emit(type, detail) {
+    const event = new CustomEvent(type, { detail });
+    this.dispatchEvent(event);
+  }
+  addEventListener(type, listener) {
+    super.addEventListener(type, listener);
+    return () => super.removeEventListener(type, listener);
+  }
+};
+
+// src/namespace-proxy.ts
+function makeNamespaceProxy(invoke, path = []) {
+  const handler = {
+    get: (target2, prop) => {
+      if (typeof prop === "string") {
+        if (!Reflect.has(target2, prop)) {
+          const next = makeNamespaceProxy(invoke, path.concat(prop));
+          Reflect.set(target2, prop, next);
+        }
+        return Reflect.get(target2, prop);
+      } else {
+        throw new Error(
+          `Cannot look up a symbol ${String(prop)} on a host connection proxy.`
+        );
+      }
+    }
+  };
+  const target = {};
+  if (path.length < 2) {
+    return new Proxy(target, handler);
+  }
+  const invoker = (...args) => invoke({
+    path: path.slice(0, -1),
+    name: path[path.length - 1],
+    args
+  });
+  return new Proxy(invoker, {
+    ...handler,
+    apply(target2, _, args) {
+      return target2(...args);
+    }
+  });
+}
+
+// src/timeout-promise.ts
+function timeoutPromise(timeoutMs, promise) {
+  return new Promise((resolve, reject) => {
+    const timeout = setTimeout(
+      () => reject(new Error(`Timed out after ${timeoutMs}ms`)),
+      timeoutMs
+    );
+    promise.then((result) => {
+      clearTimeout(timeout);
+      resolve(result);
+    }).catch(reject);
+  });
+}
+
+exports.Emitter = Emitter;
+exports._customConsole = _customConsole;
+exports.debugEmitter = debugEmitter;
+exports.makeNamespaceProxy = makeNamespaceProxy;
+exports.quietConsole = quietConsole;
+exports.timeoutPromise = timeoutPromise;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/debuglog.ts","../src/debug-emitter.ts","../src/emitter.ts","../src/namespace-proxy.ts","../src/timeout-promise.ts"],"names":["target"],"mappings":"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","sourcesContent":["/*\nCopyright 2022 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\n/**\n * Fancy looking console decorator.\n * @hidden\n * @internal\n */\n\n/** @internal */\nconst isDarkMode = () =>\n  typeof window.matchMedia === \"function\" &&\n  window.matchMedia(\"(prefers-color-scheme: dark)\").matches;\n\n/** @internal */\ntype Layout = {\n  padX: number;\n  padY: number;\n  rounded: number;\n  fontSize: number;\n  emphasis: Style;\n};\n/** @internal */\ntype HexColor = `#${string}` | \"transparent\";\n/** @internal */\ntype Color = {\n  text: HexColor;\n  bg: HexColor;\n  hilight: HexColor;\n  shadow: HexColor;\n};\n/** @internal */\ntype ThemeSpec = Color & Layout;\n\n/** @internal */\nconst Layouts: Record<string, Layout> = {\n  medium: {\n    padX: 5,\n    padY: 3,\n    rounded: 4,\n    fontSize: 100,\n    emphasis: \"font-weight: bold;\",\n  },\n  small: {\n    padX: 3,\n    padY: 1,\n    rounded: 2,\n    fontSize: 95,\n    emphasis: \"font-style: italic;\",\n  },\n};\n\n/** @internal */\nconst Colors: Record<string, Color> = {\n  yellow: {\n    text: \"#333333\",\n    bg: \"#EBD932\",\n    hilight: \"#F7E434\",\n    shadow: \"#D1C12C\",\n  },\n  green: {\n    text: \"#333333\",\n    bg: \"#96EB5E\",\n    hilight: \"#9EF763\",\n    shadow: \"#85D154\",\n  },\n  blue: {\n    text: \"#333333\",\n    bg: \"#8DD0EB\",\n    hilight: \"#88F0F7\",\n    shadow: \"#74AED4\",\n  },\n  gray: isDarkMode()\n    ? {\n        text: \"#eeeeee\",\n        bg: \"transparent\",\n        hilight: \"#cecece\",\n        shadow: \"#cecece\",\n      }\n    : {\n        text: \"#333333\",\n        bg: \"#eeeeee\",\n        hilight: \"#f6f6f6\",\n        shadow: \"#cecece\",\n      },\n};\n\n/** @internal */\ntype ThemeTag = `${keyof typeof Colors} ${keyof typeof Layouts}`;\n\n/**\n * @internal\n */\nexport type Theme = ThemeSpec | ThemeTag;\n\n/** @internal */\ntype LogDecorator = (...args: unknown[]) => unknown[];\n\n/** @internal */\ntype Style = `${string};`;\n\nfunction memoizeUnary<T, U>(fn: (arg: T) => U): typeof fn {\n  const cache: Map<T, U> = new Map();\n  return (arg) => {\n    if (!cache.has(arg)) {\n      const result = fn(arg);\n      cache.set(arg, result);\n      if (cache.size > 100) {\n        cache.delete(cache.keys().next().value as T);\n      }\n      return result;\n    }\n    return cache.get(arg);\n  };\n}\n\nconst toTheme = memoizeUnary((theme: Theme): ThemeSpec => {\n  if (typeof theme === \"string\") {\n    const [color, size] = theme.split(\" \");\n    return {\n      ...Colors[color],\n      ...Layouts[size],\n    };\n  }\n  return theme;\n});\n\nconst block: Style = `display: inline-block; border: 1px solid;`;\n\nconst flatten = (side: \"left\" | \"right\"): Style =>\n  `padding-${side}: 0px; border-${side}-width: 0px; border-top-${side}-radius: 0px; border-bottom-${side}-radius: 0px;`;\n\nconst toColor = ({ bg, hilight, shadow, text }: Color): Style =>\n  `color: ${text}; background: ${bg}; border-color: ${hilight} ${shadow} ${shadow} ${hilight};`;\n\nconst toLayout = ({ fontSize, padY, padX, rounded }: Layout) =>\n  `font-size: ${fontSize}%; padding: ${padY}px ${padX}px; border-radius: ${rounded}px;`;\n\nconst toBubbleStyle = memoizeUnary((theme: ThemeSpec): string[] => {\n  const base = `${block}${toColor(theme)}${toLayout(theme)}`;\n  return [\n    `${base}${flatten(\"right\")}`,\n    `${base}${flatten(\"left\")}${theme.emphasis}`,\n  ] as Style[];\n});\n\nfunction toBubblePrepender(\n  bubbleLeft: string,\n  bubbleRight: string,\n  theme: ThemeSpec\n): LogDecorator {\n  const prefix = `%c${bubbleLeft}%c ${bubbleRight}`;\n  const [left, right] = toBubbleStyle(theme);\n  return (args: unknown[]) => {\n    const bubbleArgs = [prefix, left, right];\n    if (typeof args[0] === \"string\") {\n      bubbleArgs[0] = `${prefix}%c ${args.shift() as string}`;\n      bubbleArgs.push(\"\"); // reset style\n    }\n    return [...bubbleArgs, ...args];\n  };\n}\n\n/** @internal */\nconst stateTypes = {\n  event: \"️⚡️\",\n} as const;\n\nconst stateDelim = \" ⤻ \";\n\n/** @internal */\ntype DebugState = { type: keyof typeof stateTypes; name: string };\n\n// Serialize to memoize.\nconst getStateFormatter = memoizeUnary((stateJson: string) => {\n  const stateStack = JSON.parse(stateJson) as unknown as DebugState[];\n  const firstState = stateStack.shift();\n  const left = stateTypes[firstState.type];\n  const right = [\n    firstState.name,\n    ...stateStack.map((state) => `${stateTypes[state.type]} ${state.name}`),\n  ].join(stateDelim);\n  return toBubblePrepender(left, right, toTheme(\"gray small\"));\n});\nconst getStatePrepender = (stateStack: DebugState[]) =>\n  getStateFormatter(JSON.stringify(stateStack));\n\nconst overrideMethods = [\"log\", \"error\", \"warn\", \"info\", \"debug\"] as const;\n\nconst identity = <T>(x: T) => x;\n\nconst noop = (): (() => undefined) => undefined;\n\n/**\n * A console, plus some methods to track event lifecycles.\n * @internal\n */\nexport interface DebugLogger extends Console {\n  /**\n   * Stop all logging; methods do nothing\n   * @internal\n   */\n  detach(): void;\n  /**\n   * Add an event bubble to the log during handler.\n   */\n  pushState(state: DebugState): void;\n  /**\n   * Remove the bubble when event is done dispatching\n   */\n  popState(): void;\n}\n\n/**\n * Returns a console whose methods autoformat with bubbles.\n * @internal\n */\nexport function _customConsole(\n  theme: Theme,\n  type: string,\n  name: string\n): DebugLogger {\n  const prepender = toBubblePrepender(`X${type}`, name, toTheme(theme));\n  let statePrepender: LogDecorator = identity as LogDecorator;\n  const stateStack: DebugState[] = [];\n  const loggerProto: PropertyDescriptorMap = {\n    detach: {\n      writable: true,\n      configurable: true,\n      value(this: DebugLogger) {\n        overrideMethods.forEach((method) => {\n          this[method] = noop;\n        });\n      },\n    },\n    pushState: {\n      value(state: DebugState) {\n        stateStack.push(state);\n        statePrepender = getStatePrepender(stateStack);\n      },\n    },\n    popState: {\n      value() {\n        stateStack.pop();\n        statePrepender =\n          stateStack.length === 0\n            ? (identity as LogDecorator)\n            : getStatePrepender(stateStack);\n      },\n    },\n  };\n  const customConsole = Object.create(\n    console,\n    overrideMethods.reduce((out, level) => {\n      out[level] = {\n        writable: true,\n        configurable: true,\n        value(...args: unknown[]) {\n          console[level](...prepender(statePrepender(args)));\n        },\n      };\n      return out;\n    }, loggerProto)\n  ) as DebugLogger;\n  return customConsole;\n}\n\n/**\n * @internal\n */\nexport const quietConsole = new Proxy(console, {\n  get() {\n    return noop;\n  },\n});\n","/*\nCopyright 2022 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\nimport { _customConsole, DebugLogger, Theme } from \"./debuglog.js\";\nimport { Emits, Unsubscriber } from \"./types.js\";\n\n/**\n * Adds methods for logging events\n * @internal\n */\nexport interface EmitterDebugLogger extends DebugLogger {\n  /**\n   * Listen to an event and pass the logger to the handler\n   * @internal\n   */\n  listen(\n    type: string,\n    listener: (logger: EmitterDebugLogger, ev: CustomEvent) => unknown\n  ): this;\n}\n\n/**\n * Debugger for EventTarget objects like Hosts, Ports and Guests, which\n * patches dispatchEvent to log events\n * Adapter to attach console logging listeners to all events on an emitter.\n * @internal\n */\nexport function debugEmitter(\n  emitter: Emits,\n  opts: {\n    theme: Theme;\n    type?: string;\n    id?: string;\n  }\n): EmitterDebugLogger {\n  const logger = _customConsole(\n    opts.theme,\n    opts.type ||\n      (Object.getPrototypeOf(emitter) as typeof emitter).constructor.name,\n    opts.id || emitter.id\n  ) as EmitterDebugLogger;\n  const oldDispatch = emitter.dispatchEvent;\n  emitter.dispatchEvent = (event) => {\n    logger.pushState({ type: \"event\", name: event.type });\n    const retVal = oldDispatch.call(emitter, event) as boolean;\n    logger.popState();\n    return retVal;\n  };\n\n  const subscriptions: Unsubscriber[] = [];\n\n  const oldDetach = logger.detach;\n  logger.detach = () => {\n    oldDetach.call(logger);\n    subscriptions.forEach((unsubscribe) => unsubscribe());\n  };\n\n  /**\n   * Listens and passes a logger to callbacks\n   */\n  function listen(\n    type: string,\n    listener: (logger: EmitterDebugLogger, ev: CustomEvent) => unknown\n  ) {\n    subscriptions.push(\n      emitter.addEventListener(type, (event) => listener(logger, event))\n    );\n    return logger;\n  }\n\n  logger.listen = listen;\n\n  return logger;\n}\n","/*\nCopyright 2022 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\nimport { Emits, Unsubscriber, NamedEvent } from \"./types.js\";\n\n/**\n * Browser-native {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget | EventTarget}\n * whose {@link Emitter.addEventListener} method returns an anonymous function\n * which unsubscribes the original handler.\n *\n * Also provides typed events via generics. You can create or extend this class\n * to define custom emitters with known event names and signatures.\n *\n * @example\n * ```ts\n * import type { NamedEvent, Emitter } from '@adobe/uix-sdk'\n *\n * class FizzBuzzEmitter extends Emitter<\n *   NamedEvent<\"fizz\", { fizzCount: number }> |\n *   NamedEvent<\"buzz\", { buzzCount: number }> |\n *   NamedEvent<\"fizzbuzz\">\n * > {\n * }\n * ```\n * The `FizzBuzzEmitter` class will now type check its events and event\n * listeners, providing autosuggest in editors.\n *\n * @see [EventTarget - MDN](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget)\n *\n * @public\n */\nexport class Emitter<Events extends NamedEvent>\n  extends EventTarget\n  implements Emits<Events>\n{\n  /**\n   * An arbitrary string to uniquely identify this emitter and its events.\n   * @public\n   */\n  id: string;\n  constructor(id: string) {\n    super();\n    this.id = id;\n  }\n  /**\n   * Convenience method to construct and dispatch custom events.\n   *\n   * @param type - Name of one of the allowed events this can emit\n   * @param detail - Object to expose in the {@link https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent/detail | CustomEvent#detail}\n   * property.\n   * @public\n   */\n  protected emit<Event extends Events>(\n    type: Event[\"type\"],\n    detail: Event[\"detail\"]\n  ): void {\n    const event = new CustomEvent<typeof detail>(type, { detail });\n    this.dispatchEvent(event);\n  }\n  /**\n   * Subscribe to an event and receive an unsubscribe callback.\n   * @see [EventTarget.addEventListener - MDN](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener)\n   *\n   * Identical to `EventTarget.addEventListener`, but returns an \"unsubscriber\"\n   * function which detaches the listener when invoked. Solves an ergonomic\n   * problem with native EventTargets where it's impossible to detach listeners\n   * without having a reference to the original handler.\n   *\n   * @typeParam E - Name of one of the allowed events this can emit\n   * @param type - Event type\n   * @param listener - Event handler\n   * @returns Call to unsubscribe listener.\n   */\n  addEventListener<\n    Type extends Events[\"type\"],\n    Event extends Extract<Events, { type: Type }>\n  >(type: Type, listener: (ev: Event) => unknown): Unsubscriber {\n    super.addEventListener(type, listener);\n    return () => super.removeEventListener(type, listener);\n  }\n}\n","/*\nCopyright 2022 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { RemoteHostApis, RemoteMethodInvoker } from \"./types.js\";\n\n/**\n * Build a fake object that turns \"method calls\" into RPC messages\n * The resulting object will recursively make more fake proxies on demand until\n * one of the looked-up properties is invoked as a function.\n * Then it will call the passed `invoke` method with a {@link HostMethodAddress}\n * that can send the method invocation as an RPC message to another realm.\n *\n * @example\n * ```js\n * const invoker = (methodAddress) => console.log(\n *   address.path,\n *   address.name,\n *   address.args\n * );\n * const ns = makeNamespaceProxy(invoker);\n *\n * // looking up any property on the object will work\n *\n * ns.example.builds.method.call.message(\"foo\", 1);\n *\n * // Console will log:\n * ['example','builds','method','call']\n * 'message'\n * [\"foo\", 1]\n *```\n * @internal\n *\n * @param invoke - Callback that receives address\n */\nexport function makeNamespaceProxy<ProxiedApi extends object>(\n  invoke: RemoteMethodInvoker<unknown>,\n  path: string[] = []\n): RemoteHostApis<ProxiedApi> {\n  const handler: ProxyHandler<Record<string, any>> = {\n    get: (target, prop) => {\n      if (typeof prop === \"string\") {\n        if (!Reflect.has(target, prop)) {\n          const next = makeNamespaceProxy(invoke, path.concat(prop));\n          Reflect.set(target, prop, next);\n        }\n        return Reflect.get(target, prop) as unknown;\n      } else {\n        throw new Error(\n          `Cannot look up a symbol ${String(prop)} on a host connection proxy.`\n        );\n      }\n    },\n  };\n  const target = {} as unknown as RemoteHostApis<ProxiedApi>;\n  // Only trap the apply if there's at least two levels of namespace.\n  // uix.host() is not a function, and neither is uix.host.bareMethod().\n  if (path.length < 2) {\n    return new Proxy<RemoteHostApis<ProxiedApi>>(target, handler);\n  }\n  const invoker = (...args: unknown[]) =>\n    invoke({\n      path: path.slice(0, -1),\n      name: path[path.length - 1],\n      args,\n    });\n  return new Proxy<typeof invoker>(invoker, {\n    ...handler,\n    apply(target, _, args: unknown[]) {\n      return target(...args);\n    },\n  }) as unknown as typeof target;\n}\n","/*\nCopyright 2022 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\n/**\n * Add a timeout to a Promise. The returned Promise will resolve to the value of\n * the original Promise, but if it doesn't resolve within the timeout interval,\n * it will reject with a timeout error.\n * @internal\n *\n * @param timeoutMs - Time to wait (ms) before rejecting\n * @param promise - Original promise to set a timeout for\n * @returns - Promise that rejects after X milliseconds have passed\n */\nexport function timeoutPromise<T>(timeoutMs: number, promise: Promise<T>) {\n  return new Promise((resolve, reject) => {\n    const timeout = setTimeout(\n      () => reject(new Error(`Timed out after ${timeoutMs}ms`)),\n      timeoutMs\n    );\n    promise\n      .then((result) => {\n        clearTimeout(timeout);\n        resolve(result);\n      })\n      .catch(reject);\n  });\n}\n"]}

package/dist/namespace-proxy.d.ts

@@ -0,0 +1,32 @@
+import { RemoteHostApis, RemoteMethodInvoker } from "./types.js";
+/**
+ * Build a fake object that turns "method calls" into RPC messages
+ * The resulting object will recursively make more fake proxies on demand until
+ * one of the looked-up properties is invoked as a function.
+ * Then it will call the passed `invoke` method with a {@link HostMethodAddress}
+ * that can send the method invocation as an RPC message to another realm.
+ *
+ * @example
+ * ```js
+ * const invoker = (methodAddress) => console.log(
+ *   address.path,
+ *   address.name,
+ *   address.args
+ * );
+ * const ns = makeNamespaceProxy(invoker);
+ *
+ * // looking up any property on the object will work
+ *
+ * ns.example.builds.method.call.message("foo", 1);
+ *
+ * // Console will log:
+ * ['example','builds','method','call']
+ * 'message'
+ * ["foo", 1]
+ *```
+ * @internal
+ *
+ * @param invoke - Callback that receives address
+ */
+export declare function makeNamespaceProxy<ProxiedApi extends object>(invoke: RemoteMethodInvoker<unknown>, path?: string[]): RemoteHostApis<ProxiedApi>;
+//# sourceMappingURL=namespace-proxy.d.ts.map

package/dist/namespace-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-proxy.d.ts","sourceRoot":"","sources":["../src/namespace-proxy.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,SAAS,MAAM,EAC1D,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC,EACpC,IAAI,GAAE,MAAM,EAAO,GAClB,cAAc,CAAC,UAAU,CAAC,CAkC5B"}

package/dist/timeout-promise.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Add a timeout to a Promise. The returned Promise will resolve to the value of
+ * the original Promise, but if it doesn't resolve within the timeout interval,
+ * it will reject with a timeout error.
+ * @internal
+ *
+ * @param timeoutMs - Time to wait (ms) before rejecting
+ * @param promise - Original promise to set a timeout for
+ * @returns - Promise that rejects after X milliseconds have passed
+ */
+export declare function timeoutPromise<T>(timeoutMs: number, promise: Promise<T>): Promise<unknown>;
+//# sourceMappingURL=timeout-promise.d.ts.map

package/dist/timeout-promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-promise.d.ts","sourceRoot":"","sources":["../src/timeout-promise.ts"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,oBAavE"}

package/dist/types.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Extract keys of T whose values are are assignable to U.
+ * @internal
+ */
+declare type ExtractKeys<T, U> = {
+    [P in keyof T]: T[P] extends U ? P : never;
+}[keyof T];
+/**
+ * @internal
+ */
+declare type GuestApiMethod = (...args: any[]) => any;
+/**
+ * @internal
+ */
+export interface GuestApiNS {
+    [k: string]: GuestApiMethod;
+}
+/**
+ * @internal
+ */
+export interface GuestApis {
+    [k: string]: GuestApiNS;
+}
+/**
+ * @internal
+ */
+export declare type RemoteGuestApiNS<G extends GuestApiNS = GuestApiNS> = {
+    [K in ExtractKeys<G, GuestApiMethod>]: (...args: Parameters<G[K]>) => Promise<ReturnType<G[K]>>;
+};
+/**
+ * @internal
+ */
+export declare type RemoteGuestApis<G extends GuestApis = GuestApis> = {
+    [K in ExtractKeys<G, GuestApiNS>]: RemoteGuestApiNS<GuestApiNS>;
+};
+/**
+ * @internal
+ */
+export declare type VirtualApi = Record<string, object | ((...args: unknown[]) => unknown)>;
+/**
+ * @internal
+ */
+export declare type RemoteHostApis<Api = VirtualApi> = {
+    [K in ExtractKeys<Api, CallableFunction | object>]: Api[K] extends (...args: unknown[]) => PromiseLike<any> ? Api[K] : Api[K] extends (...args: infer A) => infer R ? (...args: A) => Promise<R> : RemoteHostApis<Api[K]>;
+};
+/**
+
+/**
+ * An individual UI extension retrieved from the registry.
+ *
+ * @remarks This interface is likely to expand. As the metadata from the
+ * extension registry stabilizes, it should probably be passed through.
+ * Right now, there are too many cases where an extension string ID
+ * is directly used; this should probably be an opaque, structured object.
+ *
+ * @public
+ */
+export interface Extension {
+    /**
+     * Unique ID of the extension. Must be unique across entire app
+     */
+    id: string;
+    /**
+     * Location of the document to load for the {@link @adobe/uix-guest#GuestServer}
+     */
+    url: string;
+}
+/**
+ * Describes a method invocation to/from a remote realm, such as an iframe.
+ *
+ * @example Calling a host API method
+ *
+ * #### `extension.ts`
+ * ```ts
+ * // The following line causes the Guest object to build a `HostMethodAddress`
+ * // and dispatch it to the parent app
+ * uix.host.accounts.lookup.byQuery('Kevin', { pick: 'homeAddress' });
+ * ```
+ *
+ * The above call produces this `HostMethodAddress` and sends it to the invoker:
+ * ```json
+ * {
+ *  path: ["accounts","lookup"],
+ *  name: "byQuery",
+ *  args: ["Kevin", { "pick": "homeAddress" }]
+ * }
+ * ```
+ * @internal
+ *
+ */
+export interface HostMethodAddress<Args = unknown[]> {
+    /**
+     * Consecutive dot lookups on nested objects before the actual function call.
+     */
+    path: string[];
+    /**
+     * Name of the method to be called as a function.
+     */
+    name: string;
+    /**
+     * Any (serializable) arguments to the remote function.
+     */
+    args: Args;
+}
+/**
+ * A callback to pass to a new namespace proxy. It will call that
+ * call back with a {@link HostMethodAddress} when one of its properties is
+ * invoked as a method.
+ *
+ * Because the typical use case is for asynchronous cross-realm communication,
+ * the callback is expected to return a Promise for the return value.
+ * @internal
+ */
+export declare type RemoteMethodInvoker<T> = (address: HostMethodAddress) => Promise<T>;
+/**
+ * Interface for decoupling Port from GuestServer.host
+ * @internal
+ */
+export interface HostConnection<T = unknown> {
+    /**
+     * see {@link @adobe/uix-host#Port}
+     */
+    getSharedContext(): Record<string, unknown>;
+    /**
+     * see {@link @adobe/uix-host#Port}
+     */
+    invokeHostMethod: RemoteMethodInvoker<T>;
+}
+/**
+ * {@inheritDoc @adobe/uix-host#Port}
+ * @internal
+ */
+export interface GuestConnection {
+    id: string;
+    url: URL;
+    attachUI(frame: HTMLIFrameElement, privateMethods?: RemoteHostApis): {
+        promise: Promise<unknown>;
+        destroy: Function;
+    };
+    load(): Promise<unknown>;
+    error?: Error;
+    hasCapabilities(capabilities: unknown): boolean;
+    isReady(): boolean;
+    provide(apis: unknown): void;
+    unload(): Promise<unknown>;
+}
+/**
+ * BEGIN EVENTS
+ */
+/**
+ * Returned from {@link Emitter.addEventListener}. Unsubscribes the original
+ * handler when called.
+ * @internal
+ */
+export declare type Unsubscriber = () => void;
+/**
+ * Strongly typed event with a string `type` parameter.
+ * @internal
+ */
+export declare type NamedEvent<Type extends string = string, Detail = Record<string, unknown>> = CustomEvent<Detail> & {
+    readonly type: Type;
+};
+/**
+ * Typed EventTarget
+ * @internal
+ */
+export interface Emits<Events extends NamedEvent = NamedEvent> extends EventTarget {
+    id: string;
+    /**
+     * Same as EventTarget.addEventListener but returns an unsubscribe callback.
+     */
+    addEventListener<Type extends Events["type"]>(type: Type, listener: (ev: Extract<Events, {
+        type: Type;
+    }>) => unknown): () => void;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@adobe/uix-core",
+  "version": "0.6.3",
+  "description": "Internal utilities for the UIX SDK",
+  "author": "Adobe, Inc,",
+  "type": "module",
+  "module": "dist/esm/index.js",
+  "main": "dist/index.js",
+  "browser": "dist/index.js",
+  "exports": {
+    "import": "./dist/esm/index.js",
+    "require": "./dist/index.js"
+  },
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsup",
+    "watch": "tsup --watch --silent"
+  },
+  "browserslist": [
+    "> 0.2%, last 2 versions, not dead"
+  ],
+  "bugs": "https://git.corp.adobe.com/dx-devex-acceleration/uix-sdk/issues",
+  "files": [
+    "README.md",
+    "dist",
+    "src",
+    "tsconfig.json"
+  ],
+  "homepage": "https://git.corp.adobe.com/dx-devex-acceleration/uix-sdk",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://git.corp.adobe.com/dx-devex-acceleration/uix-sdk.git"
+  },
+  "sideEffects": false
+}