@mirrorstack-ai/app-module-client 0.5.1

package/dist/web/cache.js

@@ -0,0 +1,130 @@
+const DEFAULT_MAX_AGE_MS = 30_000;
+const DEFAULT_MAX_ENTRIES = 64;
+/** Returns true when an error represents an aborted browser request. */
+export function isAbortError(error) {
+    return error instanceof DOMException && error.name === "AbortError";
+}
+/**
+ * Creates an isolated text cache for one module mount.
+ *
+ * The cache stores response text so each consumer can parse its own object. It
+ * never uses browser storage and shares no state with another cache instance.
+ */
+export function createModuleTextCache(options = {}) {
+    const maxAgeMs = nonNegative(options.maxAgeMs ?? DEFAULT_MAX_AGE_MS, "maxAgeMs");
+    const maxEntries = positiveInteger(options.maxEntries ?? DEFAULT_MAX_ENTRIES, "maxEntries");
+    const now = options.now ?? Date.now;
+    const entries = new Map();
+    const inflight = new Map();
+    function remember(key, text) {
+        entries.delete(key);
+        entries.set(key, { text, storedAt: now() });
+        while (entries.size > maxEntries) {
+            const oldest = entries.keys().next();
+            if (oldest.done)
+                return;
+            entries.delete(oldest.value);
+        }
+    }
+    function attach(key, shared, signal) {
+        if (signal?.aborted === true)
+            return Promise.reject(abortError());
+        shared.waiters += 1;
+        if (signal === undefined) {
+            return shared.promise.finally(() => {
+                shared.waiters -= 1;
+            });
+        }
+        let released = false;
+        const release = () => {
+            if (released)
+                return;
+            released = true;
+            shared.waiters -= 1;
+            if (shared.waiters === 0 && inflight.get(key) === shared) {
+                inflight.delete(key);
+                shared.controller.abort();
+            }
+        };
+        return new Promise((resolve, reject) => {
+            const onAbort = () => {
+                release();
+                reject(abortError());
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+            shared.promise.then((text) => {
+                signal.removeEventListener("abort", onAbort);
+                release();
+                resolve(text);
+            }, (error) => {
+                signal.removeEventListener("abort", onAbort);
+                release();
+                reject(error);
+            });
+        });
+    }
+    async function cachedText(key, fetchText, readOptions = {}) {
+        if (readOptions.signal?.aborted === true)
+            return Promise.reject(abortError());
+        const requestedMaxAge = nonNegative(readOptions.maxAgeMs ?? maxAgeMs, "options.maxAgeMs");
+        const hit = entries.get(key);
+        if (hit !== undefined && requestedMaxAge > 0 && now() - hit.storedAt < requestedMaxAge) {
+            return hit.text;
+        }
+        const live = inflight.get(key);
+        if (live !== undefined)
+            return attach(key, live, readOptions.signal);
+        const controller = new AbortController();
+        const shared = {
+            controller,
+            promise: Promise.resolve(""),
+            waiters: 0,
+        };
+        const request = fetchText(controller.signal).then((text) => {
+            if (inflight.get(key) === shared)
+                inflight.delete(key);
+            remember(key, text);
+            return text;
+        }, (error) => {
+            if (inflight.get(key) === shared)
+                inflight.delete(key);
+            throw error;
+        });
+        Object.assign(shared, { promise: request });
+        inflight.set(key, shared);
+        return attach(key, shared, readOptions.signal);
+    }
+    function invalidate(prefix) {
+        if (prefix === undefined) {
+            entries.clear();
+            return;
+        }
+        for (const key of entries.keys()) {
+            if (key.startsWith(prefix))
+                entries.delete(key);
+        }
+    }
+    function clear() {
+        entries.clear();
+        for (const pending of inflight.values())
+            pending.controller.abort();
+        inflight.clear();
+    }
+    return Object.freeze({ cachedText, invalidate, clear });
+}
+function abortError() {
+    return new DOMException("The operation was aborted.", "AbortError");
+}
+function nonNegative(value, name) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new TypeError(`${name} must be a finite non-negative number`);
+    }
+    return value;
+}
+function positiveInteger(value, name) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new TypeError(`${name} must be a positive integer`);
+    }
+    return value;
+}
+//# sourceMappingURL=cache.js.map

package/dist/web/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/web/cache.ts"],"names":[],"mappings":"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","sourcesContent":["const DEFAULT_MAX_AGE_MS = 30_000;\nconst DEFAULT_MAX_ENTRIES = 64;\n\ninterface Entry {\n  readonly text: string;\n  readonly storedAt: number;\n}\n\ninterface Inflight {\n  readonly promise: Promise<string>;\n  readonly controller: AbortController;\n  waiters: number;\n}\n\n/** Configuration for one mount-scoped text cache. */\nexport interface ModuleTextCacheOptions {\n  /** Default freshness window for cached responses. */\n  readonly maxAgeMs?: number;\n  /** Maximum number of completed responses retained by this instance. */\n  readonly maxEntries?: number;\n  /** Clock override for deterministic tests. */\n  readonly now?: () => number;\n}\n\n/** Options for one cached read. */\nexport interface CachedTextOptions {\n  readonly signal?: AbortSignal;\n  /** Overrides the instance freshness window; zero forces a network read. */\n  readonly maxAgeMs?: number;\n}\n\n/** A request cache owned and disposed by one mounted module instance. */\nexport interface ModuleTextCache {\n  /** Returns a fresh cached response or coalesces an equivalent live request. */\n  cachedText(\n    key: string,\n    fetchText: (signal: AbortSignal) => Promise<string>,\n    options?: CachedTextOptions,\n  ): Promise<string>;\n\n  /** Removes completed entries, optionally restricted to a key prefix. */\n  invalidate(prefix?: string): void;\n\n  /** Removes completed entries and aborts every live request owned by this cache. */\n  clear(): void;\n}\n\n/** Returns true when an error represents an aborted browser request. */\nexport function isAbortError(error: unknown): boolean {\n  return error instanceof DOMException && error.name === \"AbortError\";\n}\n\n/**\n * Creates an isolated text cache for one module mount.\n *\n * The cache stores response text so each consumer can parse its own object. It\n * never uses browser storage and shares no state with another cache instance.\n */\nexport function createModuleTextCache(\n  options: ModuleTextCacheOptions = {},\n): ModuleTextCache {\n  const maxAgeMs = nonNegative(options.maxAgeMs ?? DEFAULT_MAX_AGE_MS, \"maxAgeMs\");\n  const maxEntries = positiveInteger(options.maxEntries ?? DEFAULT_MAX_ENTRIES, \"maxEntries\");\n  const now = options.now ?? Date.now;\n  const entries = new Map<string, Entry>();\n  const inflight = new Map<string, Inflight>();\n\n  function remember(key: string, text: string): void {\n    entries.delete(key);\n    entries.set(key, { text, storedAt: now() });\n    while (entries.size > maxEntries) {\n      const oldest = entries.keys().next();\n      if (oldest.done) return;\n      entries.delete(oldest.value);\n    }\n  }\n\n  function attach(key: string, shared: Inflight, signal?: AbortSignal): Promise<string> {\n    if (signal?.aborted === true) return Promise.reject(abortError());\n\n    shared.waiters += 1;\n    if (signal === undefined) {\n      return shared.promise.finally(() => {\n        shared.waiters -= 1;\n      });\n    }\n\n    let released = false;\n    const release = () => {\n      if (released) return;\n      released = true;\n      shared.waiters -= 1;\n      if (shared.waiters === 0 && inflight.get(key) === shared) {\n        inflight.delete(key);\n        shared.controller.abort();\n      }\n    };\n\n    return new Promise<string>((resolve, reject) => {\n      const onAbort = () => {\n        release();\n        reject(abortError());\n      };\n      signal.addEventListener(\"abort\", onAbort, { once: true });\n      shared.promise.then(\n        (text) => {\n          signal.removeEventListener(\"abort\", onAbort);\n          release();\n          resolve(text);\n        },\n        (error: unknown) => {\n          signal.removeEventListener(\"abort\", onAbort);\n          release();\n          reject(error);\n        },\n      );\n    });\n  }\n\n  async function cachedText(\n    key: string,\n    fetchText: (signal: AbortSignal) => Promise<string>,\n    readOptions: CachedTextOptions = {},\n  ): Promise<string> {\n    if (readOptions.signal?.aborted === true) return Promise.reject(abortError());\n    const requestedMaxAge = nonNegative(\n      readOptions.maxAgeMs ?? maxAgeMs,\n      \"options.maxAgeMs\",\n    );\n    const hit = entries.get(key);\n    if (hit !== undefined && requestedMaxAge > 0 && now() - hit.storedAt < requestedMaxAge) {\n      return hit.text;\n    }\n\n    const live = inflight.get(key);\n    if (live !== undefined) return attach(key, live, readOptions.signal);\n\n    const controller = new AbortController();\n    const shared = {\n      controller,\n      promise: Promise.resolve(\"\"),\n      waiters: 0,\n    } satisfies Inflight;\n    const request = fetchText(controller.signal).then(\n      (text) => {\n        if (inflight.get(key) === shared) inflight.delete(key);\n        remember(key, text);\n        return text;\n      },\n      (error: unknown) => {\n        if (inflight.get(key) === shared) inflight.delete(key);\n        throw error;\n      },\n    );\n    Object.assign(shared, { promise: request });\n    inflight.set(key, shared);\n    return attach(key, shared, readOptions.signal);\n  }\n\n  function invalidate(prefix?: string): void {\n    if (prefix === undefined) {\n      entries.clear();\n      return;\n    }\n    for (const key of entries.keys()) {\n      if (key.startsWith(prefix)) entries.delete(key);\n    }\n  }\n\n  function clear(): void {\n    entries.clear();\n    for (const pending of inflight.values()) pending.controller.abort();\n    inflight.clear();\n  }\n\n  return Object.freeze({ cachedText, invalidate, clear });\n}\n\nfunction abortError(): DOMException {\n  return new DOMException(\"The operation was aborted.\", \"AbortError\");\n}\n\nfunction nonNegative(value: number, name: string): number {\n  if (!Number.isFinite(value) || value < 0) {\n    throw new TypeError(`${name} must be a finite non-negative number`);\n  }\n  return value;\n}\n\nfunction positiveInteger(value: number, name: string): number {\n  if (!Number.isSafeInteger(value) || value <= 0) {\n    throw new TypeError(`${name} must be a positive integer`);\n  }\n  return value;\n}\n"]}

package/dist/web/component-mount.d.ts

@@ -0,0 +1,23 @@
+/** Lifecycle state of one component contributed by another installed module. */
+export type ModuleComponentMountStatus = "mounting" | "ready" | "unavailable" | "disposed";
+/** Mount operation invoked with a child owned by the target's document. */
+export type ModuleComponentMountOperation = (target: HTMLElement) => (() => void) | PromiseLike<() => void>;
+/** Observable lifecycle for one cross-module component mount. */
+export interface ModuleComponentMount {
+    /** Returns the stable current lifecycle state. */
+    getSnapshot(): ModuleComponentMountStatus;
+    /** Returns the mount failure retained for diagnostics, when unavailable. */
+    getError(): unknown;
+    /** Subscribes to lifecycle state changes. */
+    subscribe(listener: () => void): () => void;
+    /** Releases the contributed component and removes its document-owned child. */
+    dispose(): void;
+}
+/**
+ * Mounts a contributed component into an isolated child of the supplied target.
+ *
+ * The returned observable reports asynchronous readiness without coupling the
+ * lifecycle to React. A late successful mount is immediately disposed when its
+ * owner has already gone away.
+ */
+export declare function mountModuleComponent(target: HTMLElement, mount: ModuleComponentMountOperation): ModuleComponentMount;

package/dist/web/component-mount.js

@@ -0,0 +1,111 @@
+function promiseLike(value) {
+    return (value !== null
+        && (typeof value === "object" || typeof value === "function")
+        && typeof value.then === "function");
+}
+/**
+ * Mounts a contributed component into an isolated child of the supplied target.
+ *
+ * The returned observable reports asynchronous readiness without coupling the
+ * lifecycle to React. A late successful mount is immediately disposed when its
+ * owner has already gone away.
+ */
+export function mountModuleComponent(target, mount) {
+    const child = target.ownerDocument.createElement("div");
+    target.replaceChildren(child);
+    let status = "mounting";
+    let error;
+    let cleanup;
+    const listeners = new Set();
+    const publish = (next) => {
+        if (status === next)
+            return;
+        status = next;
+        for (const listener of listeners) {
+            try {
+                listener();
+            }
+            catch {
+                // Observer failures must not interrupt mount cleanup or state changes.
+            }
+        }
+    };
+    const unavailable = (cause) => {
+        if (status === "disposed") {
+            child.remove();
+            return;
+        }
+        error = cause;
+        child.remove();
+        publish("unavailable");
+    };
+    const mounted = (dispose) => {
+        if (typeof dispose !== "function") {
+            unavailable(new TypeError("module component mount must return a cleanup function"));
+            return;
+        }
+        if (status === "disposed") {
+            try {
+                dispose();
+            }
+            catch (cause) {
+                error = cause;
+            }
+            finally {
+                child.remove();
+            }
+            return;
+        }
+        cleanup = dispose;
+        publish("ready");
+    };
+    const controller = Object.freeze({
+        getSnapshot: () => status,
+        getError: () => error,
+        subscribe(listener) {
+            if (status === "disposed")
+                return () => { };
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        dispose() {
+            if (status === "disposed")
+                return;
+            publish("disposed");
+            listeners.clear();
+            const dispose = cleanup;
+            cleanup = undefined;
+            try {
+                dispose?.();
+            }
+            catch (cause) {
+                error = cause;
+                throw cause;
+            }
+            finally {
+                child.remove();
+            }
+        },
+    });
+    let result;
+    try {
+        result = mount(child);
+    }
+    catch (cause) {
+        unavailable(cause);
+        return controller;
+    }
+    try {
+        if (promiseLike(result)) {
+            void Promise.resolve(result).then(mounted, unavailable);
+        }
+        else {
+            mounted(result);
+        }
+    }
+    catch (cause) {
+        unavailable(cause);
+    }
+    return controller;
+}
+//# sourceMappingURL=component-mount.js.map

package/dist/web/component-mount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-mount.js","sourceRoot":"","sources":["../../src/web/component-mount.ts"],"names":[],"mappings":"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","sourcesContent":["/** Lifecycle state of one component contributed by another installed module. */\nexport type ModuleComponentMountStatus =\n  | \"mounting\"\n  | \"ready\"\n  | \"unavailable\"\n  | \"disposed\";\n\n/** Mount operation invoked with a child owned by the target's document. */\nexport type ModuleComponentMountOperation = (\n  target: HTMLElement,\n) => (() => void) | PromiseLike<() => void>;\n\n/** Observable lifecycle for one cross-module component mount. */\nexport interface ModuleComponentMount {\n  /** Returns the stable current lifecycle state. */\n  getSnapshot(): ModuleComponentMountStatus;\n  /** Returns the mount failure retained for diagnostics, when unavailable. */\n  getError(): unknown;\n  /** Subscribes to lifecycle state changes. */\n  subscribe(listener: () => void): () => void;\n  /** Releases the contributed component and removes its document-owned child. */\n  dispose(): void;\n}\n\nfunction promiseLike(value: unknown): value is PromiseLike<unknown> {\n  return (\n    value !== null\n    && (typeof value === \"object\" || typeof value === \"function\")\n    && typeof (value as PromiseLike<unknown>).then === \"function\"\n  );\n}\n\n/**\n * Mounts a contributed component into an isolated child of the supplied target.\n *\n * The returned observable reports asynchronous readiness without coupling the\n * lifecycle to React. A late successful mount is immediately disposed when its\n * owner has already gone away.\n */\nexport function mountModuleComponent(\n  target: HTMLElement,\n  mount: ModuleComponentMountOperation,\n): ModuleComponentMount {\n  const child = target.ownerDocument.createElement(\"div\");\n  target.replaceChildren(child);\n\n  let status: ModuleComponentMountStatus = \"mounting\";\n  let error: unknown;\n  let cleanup: (() => void) | undefined;\n  const listeners = new Set<() => void>();\n\n  const publish = (next: ModuleComponentMountStatus) => {\n    if (status === next) return;\n    status = next;\n    for (const listener of listeners) {\n      try {\n        listener();\n      } catch {\n        // Observer failures must not interrupt mount cleanup or state changes.\n      }\n    }\n  };\n  const unavailable = (cause: unknown) => {\n    if (status === \"disposed\") {\n      child.remove();\n      return;\n    }\n    error = cause;\n    child.remove();\n    publish(\"unavailable\");\n  };\n  const mounted = (dispose: unknown) => {\n    if (typeof dispose !== \"function\") {\n      unavailable(new TypeError(\"module component mount must return a cleanup function\"));\n      return;\n    }\n    if (status === \"disposed\") {\n      try {\n        dispose();\n      } catch (cause) {\n        error = cause;\n      } finally {\n        child.remove();\n      }\n      return;\n    }\n    cleanup = dispose as () => void;\n    publish(\"ready\");\n  };\n\n  const controller: ModuleComponentMount = Object.freeze({\n    getSnapshot: () => status,\n    getError: () => error,\n    subscribe(listener: () => void) {\n      if (status === \"disposed\") return () => {};\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    dispose() {\n      if (status === \"disposed\") return;\n      publish(\"disposed\");\n      listeners.clear();\n      const dispose = cleanup;\n      cleanup = undefined;\n      try {\n        dispose?.();\n      } catch (cause) {\n        error = cause;\n        throw cause;\n      } finally {\n        child.remove();\n      }\n    },\n  });\n\n  let result: ReturnType<ModuleComponentMountOperation>;\n  try {\n    result = mount(child);\n  } catch (cause) {\n    unavailable(cause);\n    return controller;\n  }\n\n  try {\n    if (promiseLike(result)) {\n      void Promise.resolve(result).then(mounted, unavailable);\n    } else {\n      mounted(result);\n    }\n  } catch (cause) {\n    unavailable(cause);\n  }\n  return controller;\n}\n"]}

package/dist/web/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./cache.js";
+export * from "./component-mount.js";
+export * from "./localized-text.js";
+export * from "./runtime.js";
+export * from "./subpath.js";
+export * from "./types.js";

package/dist/web/index.js

@@ -0,0 +1,7 @@
+export * from "./cache.js";
+export * from "./component-mount.js";
+export * from "./localized-text.js";
+export * from "./runtime.js";
+export * from "./subpath.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/web/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC","sourcesContent":["export * from \"./cache.js\";\nexport * from \"./component-mount.js\";\nexport * from \"./localized-text.js\";\nexport * from \"./runtime.js\";\nexport * from \"./subpath.js\";\nexport * from \"./types.js\";\n"]}

package/dist/web/localized-text.d.ts

@@ -0,0 +1,10 @@
+/** Text authored either as a literal or as locale-keyed translations. */
+export type LocalizedText = string | Readonly<Record<string, string>>;
+/**
+ * Resolves authored text without modifying the selected translation.
+ *
+ * Selection prefers an exact locale (case-insensitively), then another entry
+ * with the same primary language, then the exact fallback locale, and finally
+ * the first non-blank translation.
+ */
+export declare function resolveLocalizedText(value: LocalizedText | null | undefined, locale?: string, fallbackLocale?: string): string;

package/dist/web/localized-text.js

@@ -0,0 +1,36 @@
+function available(value) {
+    return typeof value === "string" && value.trim() !== "";
+}
+function exact(entries, locale) {
+    if (locale === undefined || locale === "")
+        return undefined;
+    const normalized = locale.toLowerCase();
+    return entries.find(([key, text]) => key.toLowerCase() === normalized && available(text))?.[1];
+}
+/**
+ * Resolves authored text without modifying the selected translation.
+ *
+ * Selection prefers an exact locale (case-insensitively), then another entry
+ * with the same primary language, then the exact fallback locale, and finally
+ * the first non-blank translation.
+ */
+export function resolveLocalizedText(value, locale, fallbackLocale = "en-US") {
+    if (typeof value === "string")
+        return available(value) ? value : "";
+    if (value === null || value === undefined)
+        return "";
+    const entries = Object.entries(value);
+    const exactLocale = exact(entries, locale);
+    if (exactLocale !== undefined)
+        return exactLocale;
+    const primaryLanguage = locale?.split("-")[0]?.toLowerCase();
+    if (primaryLanguage !== undefined && primaryLanguage !== "") {
+        const sameLanguage = entries.find(([key, text]) => key.split("-")[0]?.toLowerCase() === primaryLanguage && available(text))?.[1];
+        if (sameLanguage !== undefined)
+            return sameLanguage;
+    }
+    return exact(entries, fallbackLocale)
+        ?? entries.find(([, text]) => available(text))?.[1]
+        ?? "";
+}
+//# sourceMappingURL=localized-text.js.map

package/dist/web/localized-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localized-text.js","sourceRoot":"","sources":["../../src/web/localized-text.ts"],"names":[],"mappings":"AAGA,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,KAAK,CACZ,OAAiD,EACjD,MAA0B;IAE1B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAClC,GAAG,CAAC,WAAW,EAAE,KAAK,UAAU,IAAI,SAAS,CAAC,IAAI,CAAC,CACpD,EAAE,CAAC,CAAC,CAAC,CAAC;AACT,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAuC,EACvC,MAAe,EACf,cAAc,GAAG,OAAO;IAExB,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAErD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAElD,MAAM,eAAe,GAAG,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7D,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,KAAK,EAAE,EAAE,CAAC;QAC5D,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAChD,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,eAAe,IAAI,SAAS,CAAC,IAAI,CAAC,CACxE,EAAE,CAAC,CAAC,CAAC,CAAC;QACP,IAAI,YAAY,KAAK,SAAS;YAAE,OAAO,YAAY,CAAC;IACtD,CAAC;IAED,OAAO,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC;WAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;WAChD,EAAE,CAAC;AACV,CAAC","sourcesContent":["/** Text authored either as a literal or as locale-keyed translations. */\nexport type LocalizedText = string | Readonly<Record<string, string>>;\n\nfunction available(value: unknown): value is string {\n  return typeof value === \"string\" && value.trim() !== \"\";\n}\n\nfunction exact(\n  entries: ReadonlyArray<readonly [string, string]>,\n  locale: string | undefined,\n): string | undefined {\n  if (locale === undefined || locale === \"\") return undefined;\n  const normalized = locale.toLowerCase();\n  return entries.find(([key, text]) =>\n    key.toLowerCase() === normalized && available(text)\n  )?.[1];\n}\n\n/**\n * Resolves authored text without modifying the selected translation.\n *\n * Selection prefers an exact locale (case-insensitively), then another entry\n * with the same primary language, then the exact fallback locale, and finally\n * the first non-blank translation.\n */\nexport function resolveLocalizedText(\n  value: LocalizedText | null | undefined,\n  locale?: string,\n  fallbackLocale = \"en-US\",\n): string {\n  if (typeof value === \"string\") return available(value) ? value : \"\";\n  if (value === null || value === undefined) return \"\";\n\n  const entries = Object.entries(value);\n  const exactLocale = exact(entries, locale);\n  if (exactLocale !== undefined) return exactLocale;\n\n  const primaryLanguage = locale?.split(\"-\")[0]?.toLowerCase();\n  if (primaryLanguage !== undefined && primaryLanguage !== \"\") {\n    const sameLanguage = entries.find(([key, text]) =>\n      key.split(\"-\")[0]?.toLowerCase() === primaryLanguage && available(text)\n    )?.[1];\n    if (sameLanguage !== undefined) return sameLanguage;\n  }\n\n  return exact(entries, fallbackLocale)\n    ?? entries.find(([, text]) => available(text))?.[1]\n    ?? \"\";\n}\n"]}

package/dist/web/react.d.ts

@@ -0,0 +1,18 @@
+import { type ReactElement } from "react";
+export { usePlatformUnsavedState } from "./use-platform-unsaved-state.js";
+export { useNow } from "./use-now.js";
+/** Configuration for mounting one React-owned module surface. */
+export interface MountReactSurfaceOptions {
+    /** Catalog slug written to the host element for module-scoped styling. */
+    moduleSlug: string;
+    /** Compiled module CSS retained once per document while any mount uses it. */
+    styles?: string;
+    /** React content owned by the mounted module. */
+    element: ReactElement;
+    /** Releases mount-local resources after React unmounts. */
+    dispose?: () => void;
+}
+/**
+ * Mounts one isolated React surface and returns an idempotent cleanup function.
+ */
+export declare function mountReactSurface(target: HTMLElement, options: MountReactSurfaceOptions): () => void;

package/dist/web/react.js

@@ -0,0 +1,111 @@
+import { StrictMode, createElement } from "react";
+import { createRoot } from "react-dom/client";
+export { usePlatformUnsavedState } from "./use-platform-unsaved-state.js";
+export { useNow } from "./use-now.js";
+const stylesheetsByDocument = new WeakMap();
+function retainStylesheet(document, styles) {
+    let stylesheets = stylesheetsByDocument.get(document);
+    if (stylesheets === undefined) {
+        stylesheets = new Map();
+        stylesheetsByDocument.set(document, stylesheets);
+    }
+    let registration = stylesheets.get(styles);
+    if (registration === undefined) {
+        const element = document.createElement("style");
+        element.textContent = styles;
+        document.head.appendChild(element);
+        registration = { element, references: 0 };
+        stylesheets.set(styles, registration);
+    }
+    registration.references += 1;
+    let released = false;
+    return () => {
+        if (released)
+            return;
+        released = true;
+        registration.references -= 1;
+        if (registration.references !== 0)
+            return;
+        registration.element.remove();
+        stylesheets.delete(styles);
+        if (stylesheets.size === 0) {
+            stylesheetsByDocument.delete(document);
+        }
+    };
+}
+/**
+ * Mounts one isolated React surface and returns an idempotent cleanup function.
+ */
+export function mountReactSurface(target, options) {
+    const hadMount = target.hasAttribute("data-ms-mount");
+    const previousMount = target.getAttribute("data-ms-mount");
+    const restoreMount = () => {
+        if (hadMount && previousMount !== null) {
+            target.setAttribute("data-ms-mount", previousMount);
+        }
+        else {
+            target.removeAttribute("data-ms-mount");
+        }
+    };
+    target.setAttribute("data-ms-mount", options.moduleSlug);
+    let root;
+    let releaseStylesheet;
+    try {
+        if (options.styles !== undefined) {
+            releaseStylesheet = retainStylesheet(target.ownerDocument, options.styles);
+        }
+        root = createRoot(target);
+        root.render(createElement(StrictMode, null, options.element));
+    }
+    catch (error) {
+        try {
+            root?.unmount();
+        }
+        catch {
+            // Preserve the original mount error after best-effort cleanup.
+        }
+        try {
+            options.dispose?.();
+        }
+        catch {
+            // Preserve the original mount error after best-effort cleanup.
+        }
+        try {
+            releaseStylesheet?.();
+        }
+        catch {
+            // Preserve the original mount error after best-effort cleanup.
+        }
+        try {
+            restoreMount();
+        }
+        catch {
+            // Preserve the original mount error after best-effort cleanup.
+        }
+        throw error;
+    }
+    const mountedRoot = root;
+    let cleaned = false;
+    return () => {
+        if (cleaned)
+            return;
+        cleaned = true;
+        try {
+            mountedRoot.unmount();
+        }
+        finally {
+            try {
+                options.dispose?.();
+            }
+            finally {
+                try {
+                    releaseStylesheet?.();
+                }
+                finally {
+                    restoreMount();
+                }
+            }
+        }
+    };
+}
+//# sourceMappingURL=react.js.map

package/dist/web/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/web/react.ts"],"names":[],"mappings":"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","sourcesContent":["import { StrictMode, createElement, type ReactElement } from \"react\";\nimport { createRoot } from \"react-dom/client\";\n\nexport { usePlatformUnsavedState } from \"./use-platform-unsaved-state.js\";\nexport { useNow } from \"./use-now.js\";\n\ninterface StylesheetRegistration {\n  element: HTMLStyleElement;\n  references: number;\n}\n\nconst stylesheetsByDocument = new WeakMap<\n  Document,\n  Map<string, StylesheetRegistration>\n>();\n\nfunction retainStylesheet(document: Document, styles: string): () => void {\n  let stylesheets = stylesheetsByDocument.get(document);\n  if (stylesheets === undefined) {\n    stylesheets = new Map();\n    stylesheetsByDocument.set(document, stylesheets);\n  }\n\n  let registration = stylesheets.get(styles);\n  if (registration === undefined) {\n    const element = document.createElement(\"style\");\n    element.textContent = styles;\n    document.head.appendChild(element);\n    registration = { element, references: 0 };\n    stylesheets.set(styles, registration);\n  }\n  registration.references += 1;\n\n  let released = false;\n  return () => {\n    if (released) return;\n    released = true;\n    registration.references -= 1;\n    if (registration.references !== 0) return;\n\n    registration.element.remove();\n    stylesheets.delete(styles);\n    if (stylesheets.size === 0) {\n      stylesheetsByDocument.delete(document);\n    }\n  };\n}\n\n/** Configuration for mounting one React-owned module surface. */\nexport interface MountReactSurfaceOptions {\n  /** Catalog slug written to the host element for module-scoped styling. */\n  moduleSlug: string;\n  /** Compiled module CSS retained once per document while any mount uses it. */\n  styles?: string;\n  /** React content owned by the mounted module. */\n  element: ReactElement;\n  /** Releases mount-local resources after React unmounts. */\n  dispose?: () => void;\n}\n\n/**\n * Mounts one isolated React surface and returns an idempotent cleanup function.\n */\nexport function mountReactSurface(\n  target: HTMLElement,\n  options: MountReactSurfaceOptions,\n): () => void {\n  const hadMount = target.hasAttribute(\"data-ms-mount\");\n  const previousMount = target.getAttribute(\"data-ms-mount\");\n  const restoreMount = () => {\n    if (hadMount && previousMount !== null) {\n      target.setAttribute(\"data-ms-mount\", previousMount);\n    } else {\n      target.removeAttribute(\"data-ms-mount\");\n    }\n  };\n  target.setAttribute(\"data-ms-mount\", options.moduleSlug);\n\n  let root: ReturnType<typeof createRoot> | undefined;\n  let releaseStylesheet: (() => void) | undefined;\n  try {\n    if (options.styles !== undefined) {\n      releaseStylesheet = retainStylesheet(target.ownerDocument, options.styles);\n    }\n    root = createRoot(target);\n    root.render(createElement(StrictMode, null, options.element));\n  } catch (error) {\n    try {\n      root?.unmount();\n    } catch {\n      // Preserve the original mount error after best-effort cleanup.\n    }\n    try {\n      options.dispose?.();\n    } catch {\n      // Preserve the original mount error after best-effort cleanup.\n    }\n    try {\n      releaseStylesheet?.();\n    } catch {\n      // Preserve the original mount error after best-effort cleanup.\n    }\n    try {\n      restoreMount();\n    } catch {\n      // Preserve the original mount error after best-effort cleanup.\n    }\n    throw error;\n  }\n  const mountedRoot = root;\n\n  let cleaned = false;\n  return () => {\n    if (cleaned) return;\n    cleaned = true;\n    try {\n      mountedRoot.unmount();\n    } finally {\n      try {\n        options.dispose?.();\n      } finally {\n        try {\n          releaseStylesheet?.();\n        } finally {\n          restoreMount();\n        }\n      }\n    }\n  };\n}\n"]}

package/dist/web/runtime.d.ts

@@ -0,0 +1,60 @@
+import { type ModuleClientContext } from "../plugin.js";
+import type { PlatformFetch } from "./types.js";
+/** Configuration owned by the host at module mount time. */
+export interface CreateModuleWebTransportsOptions {
+    /** Canonical 1-16 character catalog slug or UUID used for routing and diagnostics. */
+    readonly moduleRef: string;
+    /** Dispatch root for this mounted module. Empty means same-origin. */
+    readonly apiBase?: string;
+    /** Authenticated fetch capability supplied by the platform host. */
+    readonly fetch?: PlatformFetch;
+    /** Maximum bytes parsed from response bodies. Defaults to one mebibyte. */
+    readonly maxResponseBytes?: number;
+}
+/** Public-root and platform-scoped transports for one mounted module. */
+export type ModuleWebTransports = ModuleClientContext;
+export declare function createModuleWebTransports(options: CreateModuleWebTransportsOptions): ModuleWebTransports;
+/**
+ * Options for an API request made through the v0.1.0 compatibility transport.
+ *
+ * @deprecated Prefer the complete scoped request options exposed by
+ * `createModuleWebTransports()`.
+ */
+export interface ModuleWebRequestOptions {
+    body?: unknown;
+    headers?: HeadersInit;
+    query?: Record<string, boolean | number | string | null | undefined>;
+    signal?: AbortSignal;
+}
+/**
+ * Configuration for the v0.1.0 compatibility transport.
+ *
+ * `appId` remains accepted for source compatibility but is informational.
+ * It is never converted into a trusted `X-MS-App-ID` browser header.
+ *
+ * @deprecated Prefer {@link CreateModuleWebTransportsOptions}.
+ */
+export interface CreateModuleWebTransportOptions {
+    moduleRef: string;
+    apiBase?: string;
+    appId?: string;
+    fetch?: PlatformFetch;
+}
+/**
+ * Direct v0.1.0 module transport for public-root and platform-scoped routes.
+ *
+ * @deprecated Prefer {@link ModuleWebTransports}.
+ */
+export interface ModuleWebTransport {
+    /** Sends a request and parses a successful JSON body. */
+    request<T>(method: string, route: string, options?: ModuleWebRequestOptions): Promise<T>;
+    /** Sends a request and returns its successful body as text. */
+    text(method: string, route: string, options?: ModuleWebRequestOptions): Promise<string>;
+}
+/**
+ * Creates the direct route-dispatching transport released in v0.1.0.
+ *
+ * @deprecated Prefer {@link createModuleWebTransports}, which keeps public and
+ * platform routes structurally separate and exposes the full scoped contract.
+ */
+export declare function createModuleWebTransport(options: CreateModuleWebTransportOptions): ModuleWebTransport;