fortiplugin-bundle-adapter 0.0.7 → 0.0.9

package/dist/runtime/index.cjs

@@ -0,0 +1,274 @@
+"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);
+
+// src/runtime/index.ts
+var runtime_exports = {};
+__export(runtime_exports, {
+  createFactory: () => createFactory,
+  createPluginResolver: () => createPluginResolver
+});
+module.exports = __toCommonJS(runtime_exports);
+
+// src/runtime/create-factory.ts
+function isObject(v) {
+  return !!v && typeof v === "object";
+}
+function isCallable(v) {
+  return typeof v === "function";
+}
+var REACT_ELEMENT_SYMBOLS = /* @__PURE__ */ new Set([
+  /* @__PURE__ */ Symbol.for("react.element"),
+  /* @__PURE__ */ Symbol.for("react.transitional.element")
+]);
+function isReactElement(v) {
+  if (!isObject(v)) return false;
+  const x = v.$$typeof;
+  return typeof x === "symbol" && REACT_ELEMENT_SYMBOLS.has(x);
+}
+function unwrapNamespaceDefault(mod) {
+  if (!mod) return mod;
+  if (isObject(mod) && "default" in mod) return mod.default;
+  return mod;
+}
+function pickExport(mod, exportName) {
+  if (!mod) return void 0;
+  if (isObject(mod) && exportName in mod) return mod[exportName];
+  if (exportName === "default") return unwrapNamespaceDefault(mod);
+  return void 0;
+}
+function looksTaggedFactory(fn, tagKey) {
+  return fn?.[tagKey] === true;
+}
+function isAbsoluteHttpUrl(url) {
+  return /^https?:\/\//i.test(String(url ?? "").trim());
+}
+function getLaravelOrigin() {
+  const ziggyUrl = window?.Ziggy?.url;
+  if (typeof ziggyUrl === "string" && ziggyUrl.length) {
+    return new URL(ziggyUrl).origin;
+  }
+  return window.location.origin.replace(/:\d+$/, "");
+}
+async function maybeImportUrl(url) {
+  const raw = String(url ?? "").trim();
+  if (!raw) throw new Error("Missing import url");
+  if (isAbsoluteHttpUrl(raw)) {
+    throw new Error(`Absolute import urls are not allowed: ${raw}`);
+  }
+  const path = raw.startsWith("/") ? raw : `/${raw}`;
+  const finalUrl = `${getLaravelOrigin()}${path}`;
+  return import(
+    /* @vite-ignore */
+    finalUrl
+  );
+}
+async function createFactory(file, env, opts = {}, hostPropsOverride) {
+  const exportName = opts.exportName ?? "default";
+  const mode = opts.mode ?? "auto";
+  const unwrapReturnedDefault = opts.unwrapReturnedDefault ?? true;
+  const runtimeKey = opts.runtimeKey ?? "imports";
+  const tagKey = opts.tagKey ?? "__forti_prep_factory__";
+  const hostUrlsOverride = opts.hostUrlsOverride ?? false;
+  const mod = await import(
+    /* @vite-ignore */
+    file
+  );
+  const picked = pickExport(mod, exportName);
+  if (picked == null) {
+    const keys = isObject(mod) ? Object.keys(mod) : [];
+    throw new Error(
+      `[fortiplugin-bundle-adapter] Export "${exportName}" not found in "${file}". Available keys: ${keys.length ? keys.join(", ") : "(none)"}`
+    );
+  }
+  const imports = {
+    react: env.react,
+    "react/jsx-runtime": env.jsxRuntime,
+    ...env.imports ?? {}
+  };
+  if (env.hostUrls) {
+    for (const [id, url] of Object.entries(env.hostUrls)) {
+      const already = Object.prototype.hasOwnProperty.call(imports, id);
+      if (already && !hostUrlsOverride) continue;
+      try {
+        imports[id] = await maybeImportUrl(url);
+      } catch (err) {
+        const msg = err?.message ? String(err.message) : String(err);
+        throw new Error(
+          `[fortiplugin-bundle-adapter] Failed to import host URL for "${id}".
+URL: ${url}
+Error: ${msg}`
+        );
+      }
+    }
+  }
+  const deps = {
+    [runtimeKey]: imports,
+    ...env.depsExtra ?? {}
+  };
+  let component = picked;
+  let wasFactory = false;
+  if (mode !== "component" && isCallable(picked)) {
+    const fn = picked;
+    const shouldTryCall = mode === "factory" || looksTaggedFactory(fn, tagKey) || mode === "auto";
+    if (shouldTryCall) {
+      let resolved;
+      try {
+        resolved = fn(deps);
+        if (resolved && typeof resolved.then === "function") {
+          resolved = await resolved;
+        }
+      } catch (err) {
+        if (mode === "factory") throw err;
+        resolved = void 0;
+      }
+      if (unwrapReturnedDefault && isObject(resolved) && "default" in resolved) {
+        resolved = resolved.default;
+      }
+      const looksLikeWeCalledAComponent = isReactElement(resolved) || resolved == null;
+      if (!looksLikeWeCalledAComponent) {
+        component = resolved;
+        wasFactory = true;
+      } else if (mode === "factory") {
+        throw new Error(
+          `[fortiplugin-bundle-adapter] Factory call did not return a component export for "${file}". Got: ${resolved == null ? String(resolved) : "ReactElement"}`
+        );
+      }
+    }
+  }
+  const hostProps = {
+    ...env.hostProps ?? {},
+    ...hostPropsOverride ?? {}
+  };
+  const render = ((renderProps) => {
+    const mergedProps = { ...renderProps ?? {}, ...hostProps };
+    if (isReactElement(component)) {
+      const clone = env.react.cloneElement;
+      return typeof clone === "function" ? clone(component, mergedProps) : component;
+    }
+    return env.react.createElement(component, mergedProps);
+  });
+  render.component = component;
+  render.module = mod;
+  render.exportName = exportName;
+  render.wasFactory = wasFactory;
+  render.file = file;
+  render.imports = imports;
+  render.hostProps = hostProps;
+  return render;
+}
+
+// src/runtime/create-resolver.ts
+function mergeRecord(a, b) {
+  return { ...a ?? {}, ...b ?? {} };
+}
+function mergeEnv(base, patch) {
+  if (!patch) return base;
+  return {
+    ...base,
+    ...patch,
+    // deep-merge the maps
+    imports: mergeRecord(base.imports, patch.imports),
+    hostUrls: mergeRecord(base.hostUrls, patch.hostUrls),
+    depsExtra: mergeRecord(base.depsExtra, patch.depsExtra),
+    // hostProps handled separately by resolver (priority props contract)
+    hostProps: base.hostProps
+  };
+}
+function mergeOptions(base, patch) {
+  return { ...base ?? {}, ...patch ?? {} };
+}
+function createPluginResolver(config) {
+  const defaults = {
+    env: config.env,
+    options: config.options ?? {},
+    hostProps: config.hostProps ?? {}
+  };
+  const R = defaults.env.react;
+  async function resolve(file, overrides) {
+    const env = mergeEnv(defaults.env, overrides?.env);
+    const options = mergeOptions(defaults.options, overrides?.options);
+    const hostProps = mergeRecord(defaults.hostProps, overrides?.hostProps);
+    return createFactory(file, env, options, hostProps);
+  }
+  function withOverrides(overrides) {
+    return createPluginResolver({
+      env: mergeEnv(defaults.env, overrides.env),
+      options: mergeOptions(defaults.options, overrides.options),
+      hostProps: mergeRecord(defaults.hostProps, overrides.hostProps)
+    });
+  }
+  function Embed(p) {
+    const { file, props, hostProps, overrides, fallback = null, onErrorRender, onResolved } = p;
+    const [renderFn, setRenderFn] = R.useState(null);
+    const [error, setError] = R.useState(null);
+    const latest = R.useRef({ props, hostProps, overrides, onResolved });
+    latest.current = { props, hostProps, overrides, onResolved };
+    R.useEffect(() => {
+      let cancelled = false;
+      setRenderFn(null);
+      setError(null);
+      (async () => {
+        try {
+          const mergedOverrides = {
+            ...latest.current.overrides ?? {},
+            hostProps: mergeRecord(
+              latest.current.overrides?.hostProps ?? {},
+              latest.current.hostProps ?? {}
+            )
+          };
+          const prepared = await resolve(file, mergedOverrides);
+          if (cancelled) return;
+          setRenderFn(() => prepared);
+          latest.current.onResolved?.({
+            file: prepared.file,
+            exportName: prepared.exportName,
+            wasFactory: prepared.wasFactory,
+            component: prepared.component,
+            module: prepared.module
+          });
+        } catch (e) {
+          if (cancelled) return;
+          setError(e);
+        }
+      })();
+      return () => {
+        cancelled = true;
+      };
+    }, [file]);
+    if (error) {
+      if (onErrorRender) return onErrorRender(error);
+      const msg = String(error?.stack ?? error?.message ?? error);
+      return R.createElement("pre", { style: { whiteSpace: "pre-wrap" } }, msg);
+    }
+    if (!renderFn) return fallback;
+    return renderFn(latest.current.props);
+  }
+  return {
+    resolve,
+    with: withOverrides,
+    Embed,
+    defaults
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createFactory,
+  createPluginResolver
+});
+//# sourceMappingURL=index.cjs.map

package/dist/runtime/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/index.ts","../../src/runtime/create-factory.ts","../../src/runtime/create-resolver.ts"],"sourcesContent":["export * from './create-factory';\r\nexport * from './create-resolver';","// src/runtime/create-factory.ts\r\n// noinspection GrazieInspection\r\n\r\nimport type * as ReactNS from \"react\";\r\nimport type * as JsxRuntimeNS from \"react/jsx-runtime\";\r\n\r\nexport type ReactLike = typeof ReactNS;\r\nexport type JsxRuntimeLike = typeof JsxRuntimeNS;\r\n\r\nexport type ImportMap = Record<string, any>;\r\n\r\nexport type CreateFactoryEnv = {\r\n    react: ReactLike;\r\n    jsxRuntime: JsxRuntimeLike;\r\n\r\n    /**\r\n     * Optional injected modules (merged into the import map).\r\n     * Example: { \"@inertiajs/core\": InertiaCore, \"@host/ui\": HostUI }\r\n     */\r\n    imports?: ImportMap;\r\n\r\n    /**\r\n     * Optional mapping of virtual IDs to CORS-safe ESM URLs for local dev.\r\n     * These URLs will be dynamically imported and added into the import map.\r\n     */\r\n    hostUrls?: Record<string, string>;\r\n\r\n    /**\r\n     * Optional base props coming from the host runtime / plugin caller.\r\n     * These props are **PRIORITY** and override any props passed to `render()`.\r\n     */\r\n    hostProps?: Record<string, any>;\r\n\r\n    /**\r\n     * Extra arbitrary values the host wants to pass into the factory deps object.\r\n     */\r\n    depsExtra?: Record<string, any>;\r\n};\r\n\r\nexport type CreateFactoryOptions = {\r\n    exportName?: string; // default: \"default\"\r\n    mode?: \"auto\" | \"factory\" | \"component\"; // default: \"auto\"\r\n    unwrapReturnedDefault?: boolean; // default: true\r\n    runtimeKey?: string; // default: \"imports\"\r\n    tagKey?: string; // default: \"__forti_prep_factory__\"\r\n    hostUrlsOverride?: boolean; // default: false\r\n};\r\n\r\nfunction isObject(v: unknown): v is Record<string, any> {\r\n    return !!v && typeof v === \"object\";\r\n}\r\n\r\nfunction isCallable(v: unknown): v is (...args: any[]) => any {\r\n    return typeof v === \"function\";\r\n}\r\n\r\nconst REACT_ELEMENT_SYMBOLS = new Set<symbol>([\r\n    Symbol.for(\"react.element\"),\r\n    Symbol.for(\"react.transitional.element\"),\r\n]);\r\n\r\nfunction isReactElement(v: unknown): boolean {\r\n    if (!isObject(v)) return false;\r\n    const x = (v as any).$$typeof;\r\n    return typeof x === \"symbol\" && REACT_ELEMENT_SYMBOLS.has(x);\r\n}\r\n\r\nfunction unwrapNamespaceDefault(mod: any): any {\r\n    if (!mod) return mod;\r\n    if (isObject(mod) && \"default\" in mod) return mod.default;\r\n    return mod;\r\n}\r\n\r\nfunction pickExport(mod: any, exportName: string): any {\r\n    if (!mod) return undefined;\r\n\r\n    if (isObject(mod) && exportName in mod) return mod[exportName];\r\n\r\n    if (exportName === \"default\") return unwrapNamespaceDefault(mod);\r\n\r\n    return undefined;\r\n}\r\n\r\nfunction looksTaggedFactory(fn: Function, tagKey: string): boolean {\r\n    return (fn as any)?.[tagKey] === true;\r\n}\r\n\r\nfunction isAbsoluteHttpUrl(url: string): boolean {\r\n    return /^https?:\\/\\//i.test(String(url ?? '').trim());\r\n}\r\n\r\nfunction getLaravelOrigin(): string {\r\n    const ziggyUrl = (window as any)?.Ziggy?.url;\r\n    if (typeof ziggyUrl === 'string' && ziggyUrl.length) {\r\n        return new URL(ziggyUrl).origin;\r\n    }\r\n    return window.location.origin.replace(/:\\d+$/, '');\r\n}\r\n\r\n/**\r\n * Import only non-absolute URLs.\r\n * - Rejects http(s) absolute URLs\r\n * - Accepts site-relative URLs like \"/vendor/...\" or \"/anything/...\"\r\n * - Forces the Laravel origin to avoid Vite :5173\r\n */\r\nasync function maybeImportUrl(url: string): Promise<any> {\r\n    const raw = String(url ?? '').trim();\r\n    if (!raw) throw new Error('Missing import url');\r\n\r\n    // must NOT be absolute\r\n    if (isAbsoluteHttpUrl(raw)) {\r\n        throw new Error(`Absolute import urls are not allowed: ${raw}`);\r\n    }\r\n\r\n    // normalize to site-relative\r\n    const path = raw.startsWith('/') ? raw : `/${raw}`;\r\n\r\n    // force Laravel origin (avoid Vite :5173)\r\n    const finalUrl = `${getLaravelOrigin()}${path}`;\r\n\r\n    // IMPORTANT: url is runtime-dynamic → Vite must not pre-bundle it\r\n    // @ts-ignore\r\n    return import(/* @vite-ignore */ finalUrl);\r\n}\r\n\r\nexport type PreparedRenderFactory<P = any> = ((props?: Partial<P>) => any) & {\r\n    component: any;\r\n    module: any;\r\n    exportName: string;\r\n    wasFactory: boolean;\r\n    file: string;\r\n\r\n    /**\r\n     * The final import map passed into the factory deps.\r\n     */\r\n    imports: ImportMap;\r\n\r\n    /**\r\n     * Host/base props attached to the renderer (priority).\r\n     */\r\n    hostProps: Record<string, any>;\r\n};\r\n\r\n/**\r\n * Import `file` NOW, resolve the component export (default or named),\r\n * then return a render factory you can call later with component props.\r\n */\r\nexport async function createFactory<P = any>(\r\n    file: string,\r\n    env: CreateFactoryEnv,\r\n    opts: CreateFactoryOptions = {},\r\n    hostPropsOverride?: Partial<P>\r\n): Promise<PreparedRenderFactory<P>> {\r\n    const exportName = opts.exportName ?? \"default\";\r\n    const mode = opts.mode ?? \"auto\";\r\n    const unwrapReturnedDefault = opts.unwrapReturnedDefault ?? true;\r\n    const runtimeKey = opts.runtimeKey ?? \"imports\";\r\n    const tagKey = opts.tagKey ?? \"__forti_prep_factory__\";\r\n    const hostUrlsOverride = opts.hostUrlsOverride ?? false;\r\n\r\n    // 1) Import the plugin module/bundle\r\n    const mod = (await import(/* @vite-ignore */ file)) as any;\r\n\r\n    const picked = pickExport(mod, exportName);\r\n    if (picked == null) {\r\n        const keys = isObject(mod) ? Object.keys(mod) : [];\r\n        throw new Error(\r\n            `[fortiplugin-bundle-adapter] Export \"${exportName}\" not found in \"${file}\". ` +\r\n            `Available keys: ${keys.length ? keys.join(\", \") : \"(none)\"}`\r\n        );\r\n    }\r\n\r\n    // 2) Build import map for the adapted wrapper\r\n    const imports: ImportMap = {\r\n        react: env.react,\r\n        \"react/jsx-runtime\": env.jsxRuntime,\r\n        ...(env.imports ?? {}),\r\n    };\r\n\r\n    // 3) Dev-mode host bundles by URL (CORS-safe ESM)\r\n    if (env.hostUrls) {\r\n        for (const [id, url] of Object.entries(env.hostUrls)) {\r\n            const already = Object.prototype.hasOwnProperty.call(imports, id);\r\n            if (already && !hostUrlsOverride) continue;\r\n\r\n            try {\r\n                imports[id] = await maybeImportUrl(url);\r\n            } catch (err: any) {\r\n                const msg = err?.message ? String(err.message) : String(err);\r\n                throw new Error(\r\n                    `[fortiplugin-bundle-adapter] Failed to import host URL for \"${id}\".\\n` +\r\n                    `URL: ${url}\\n` +\r\n                    `Error: ${msg}`\r\n                );\r\n            }\r\n        }\r\n    }\r\n\r\n    // 4) deps object for adapted wrapper (we always pass explicit object)\r\n    const deps = {\r\n        [runtimeKey]: imports,\r\n        ...(env.depsExtra ?? {}),\r\n    };\r\n\r\n    let component: any = picked;\r\n    let wasFactory = false;\r\n\r\n    // 5) Resolve factory → component (only if needed)\r\n    if (mode !== \"component\" && isCallable(picked)) {\r\n        const fn = picked as (deps: any) => any;\r\n\r\n        const shouldTryCall =\r\n            mode === \"factory\" || looksTaggedFactory(fn, tagKey) || mode === \"auto\";\r\n\r\n        if (shouldTryCall) {\r\n            let resolved: any;\r\n\r\n            try {\r\n                resolved = fn(deps);\r\n                if (resolved && typeof (resolved as any).then === \"function\") {\r\n                    resolved = await resolved;\r\n                }\r\n            } catch (err) {\r\n                if (mode === \"factory\") throw err;\r\n                resolved = undefined; // rollback in auto\r\n            }\r\n\r\n            if (unwrapReturnedDefault && isObject(resolved) && \"default\" in resolved) {\r\n                resolved = (resolved as any).default;\r\n            }\r\n\r\n            const looksLikeWeCalledAComponent =\r\n                isReactElement(resolved) || resolved == null;\r\n\r\n            if (!looksLikeWeCalledAComponent) {\r\n                component = resolved;\r\n                wasFactory = true;\r\n            } else if (mode === \"factory\") {\r\n                throw new Error(\r\n                    `[fortiplugin-bundle-adapter] Factory call did not return a component export for \"${file}\". ` +\r\n                    `Got: ${resolved == null ? String(resolved) : \"ReactElement\"}`\r\n                );\r\n            }\r\n            // auto mode rollback => treat picked as component\r\n        }\r\n    }\r\n\r\n    // 6) Host props are PRIORITY (override render() props)\r\n    const hostProps: Record<string, any> = {\r\n        ...(env.hostProps ?? {}),\r\n        ...(hostPropsOverride ?? {}),\r\n    };\r\n\r\n    // 7) Render function merges:\r\n    //    renderProps (defaults) + hostProps (priority)\r\n    const render = ((renderProps?: Partial<P>) => {\r\n        const mergedProps = {...(renderProps ?? {}), ...hostProps} as any;\r\n\r\n        if (isReactElement(component)) {\r\n            // If component is already an element, attach merged props via cloneElement\r\n            const clone = (env.react as any).cloneElement;\r\n            return typeof clone === \"function\" ? clone(component, mergedProps) : component;\r\n        }\r\n\r\n        return (env.react as any).createElement(component, mergedProps);\r\n    }) as PreparedRenderFactory<P>;\r\n\r\n    render.component = component;\r\n    render.module = mod;\r\n    render.exportName = exportName;\r\n    render.wasFactory = wasFactory;\r\n    render.file = file;\r\n    render.imports = imports;\r\n    render.hostProps = hostProps;\r\n\r\n    return render;\r\n}","// src/runtime/create-resolver.ts\r\n\r\nimport type {\r\n    CreateFactoryEnv,\r\n    CreateFactoryOptions,\r\n    PreparedRenderFactory,\r\n} from \"./create-factory\";\r\nimport {createFactory} from \"./create-factory\";\r\n\r\nexport type CreateResolverConfig = {\r\n    env: CreateFactoryEnv;\r\n    options?: CreateFactoryOptions;\r\n\r\n    /**\r\n     * Base host props (priority) that should always be applied.\r\n     * These override any props passed to render().\r\n     */\r\n    hostProps?: Record<string, any>;\r\n};\r\n\r\nexport type ResolveOverrides = {\r\n    env?: Partial<CreateFactoryEnv>;\r\n    options?: Partial<CreateFactoryOptions>;\r\n    hostProps?: Record<string, any>;\r\n};\r\n\r\nfunction mergeRecord(a?: Record<string, any>, b?: Record<string, any>) {\r\n    return {...(a ?? {}), ...(b ?? {})};\r\n}\r\n\r\nfunction mergeEnv(base: CreateFactoryEnv, patch?: Partial<CreateFactoryEnv>): CreateFactoryEnv {\r\n    if (!patch) return base;\r\n\r\n    return {\r\n        ...base,\r\n        ...patch,\r\n        // deep-merge the maps\r\n        imports: mergeRecord(base.imports, patch.imports),\r\n        hostUrls: mergeRecord(base.hostUrls, patch.hostUrls),\r\n        depsExtra: mergeRecord(base.depsExtra, patch.depsExtra),\r\n        // hostProps handled separately by resolver (priority props contract)\r\n        hostProps: base.hostProps,\r\n    };\r\n}\r\n\r\nfunction mergeOptions(\r\n    base?: CreateFactoryOptions,\r\n    patch?: Partial<CreateFactoryOptions>\r\n): CreateFactoryOptions {\r\n    return {...(base ?? {}), ...(patch ?? {})};\r\n}\r\n\r\nexport type PluginResolver = {\r\n    /**\r\n     * Resolve a plugin entry (file URL/path) into a callable renderer.\r\n     * You can pass per-call overrides (e.g. inertia imports).\r\n     */\r\n    resolve<P = any>(file: string, overrides?: ResolveOverrides): Promise<PreparedRenderFactory<P>>;\r\n\r\n    /**\r\n     * Create a new resolver inheriting this resolver, with extra defaults.\r\n     * Great for adding inertia / host UI / dev URLs once, then reusing everywhere.\r\n     */\r\n    with(overrides: ResolveOverrides): PluginResolver;\r\n\r\n    /**\r\n     * A React component already bound to this resolver.\r\n     * Only needs `file` and props.\r\n     */\r\n    Embed: <P extends Record<string, any> = Record<string, any>>(\r\n        props: EmbedProps<P>\r\n    ) => any;\r\n\r\n    /**\r\n     * Expose effective defaults (handy for debugging).\r\n     */\r\n    defaults: Required<CreateResolverConfig>;\r\n};\r\n\r\nexport type EmbedProps<P extends Record<string, any> = Record<string, any>> = {\r\n    file: string;\r\n\r\n    /**\r\n     * Default props (non-priority).\r\n     * Host props override these.\r\n     */\r\n    props?: Partial<P>;\r\n\r\n    /**\r\n     * Per-embed host props (priority).\r\n     * These override `props`.\r\n     */\r\n    hostProps?: Partial<P>;\r\n\r\n    /**\r\n     * Per-embed resolver overrides (env/options/hostProps).\r\n     * Useful when a specific plugin needs inertia, etc.\r\n     */\r\n    overrides?: ResolveOverrides;\r\n\r\n    fallback?: any;\r\n    onErrorRender?: (error: unknown) => any;\r\n\r\n    onResolved?: (info: {\r\n        file: string;\r\n        exportName: string;\r\n        wasFactory: boolean;\r\n        component: any;\r\n        module: any;\r\n    }) => void;\r\n};\r\n\r\nexport function createPluginResolver(config: CreateResolverConfig): PluginResolver {\r\n    const defaults: Required<CreateResolverConfig> = {\r\n        env: config.env,\r\n        options: config.options ?? {},\r\n        hostProps: config.hostProps ?? {},\r\n    };\r\n\r\n    const R = defaults.env.react as any;\r\n\r\n    async function resolve<P = any>(file: string, overrides?: ResolveOverrides) {\r\n        const env = mergeEnv(defaults.env, overrides?.env);\r\n        const options = mergeOptions(defaults.options, overrides?.options);\r\n\r\n        // Priority host props contract:\r\n        // - base resolver hostProps always apply\r\n        // - per-call overrides hostProps can add/override base hostProps\r\n        const hostProps = mergeRecord(defaults.hostProps, overrides?.hostProps);\r\n\r\n        // @ts-ignore\r\n        return createFactory<P>(file, env, options, hostProps);\r\n    }\r\n\r\n    function withOverrides(overrides: ResolveOverrides): PluginResolver {\r\n        return createPluginResolver({\r\n            env: mergeEnv(defaults.env, overrides.env),\r\n            options: mergeOptions(defaults.options, overrides.options),\r\n            hostProps: mergeRecord(defaults.hostProps, overrides.hostProps),\r\n        });\r\n    }\r\n\r\n    function Embed<P extends Record<string, any> = Record<string, any>>(p: EmbedProps<P>) {\r\n        const {file, props, hostProps, overrides, fallback = null, onErrorRender, onResolved} = p;\r\n\r\n        const [renderFn, setRenderFn] = R.useState(null as null | ((pp?: Partial<P>) => any));\r\n        const [error, setError] = R.useState(null as unknown);\r\n\r\n        // keep latest values without constantly re-resolving\r\n        const latest = R.useRef({props, hostProps, overrides, onResolved});\r\n        latest.current = {props, hostProps, overrides, onResolved};\r\n\r\n        R.useEffect(() => {\r\n            let cancelled = false;\r\n            setRenderFn(null);\r\n            setError(null);\r\n\r\n            (async () => {\r\n                try {\r\n                    // merge per-embed priority hostProps into per-call overrides\r\n                    const mergedOverrides: ResolveOverrides = {\r\n                        ...(latest.current.overrides ?? {}),\r\n                        hostProps: mergeRecord(\r\n                            (latest.current.overrides?.hostProps ?? {}),\r\n                            (latest.current.hostProps as any) ?? {}\r\n                        ),\r\n                    };\r\n\r\n                    const prepared = await resolve<P>(file, mergedOverrides);\r\n\r\n                    if (cancelled) return;\r\n\r\n                    setRenderFn(() => prepared);\r\n\r\n                    latest.current.onResolved?.({\r\n                        file: prepared.file,\r\n                        exportName: prepared.exportName,\r\n                        wasFactory: prepared.wasFactory,\r\n                        component: prepared.component,\r\n                        module: prepared.module,\r\n                    });\r\n                } catch (e) {\r\n                    if (cancelled) return;\r\n                    setError(e);\r\n                }\r\n            })();\r\n\r\n            return () => {\r\n                cancelled = true;\r\n            };\r\n        }, [file]);\r\n\r\n        if (error) {\r\n            if (onErrorRender) return onErrorRender(error);\r\n            const msg = String((error as any)?.stack ?? (error as any)?.message ?? error);\r\n            return R.createElement(\"pre\", {style: {whiteSpace: \"pre-wrap\"}}, msg);\r\n        }\r\n\r\n        if (!renderFn) return fallback;\r\n\r\n        // NOTE: createFactory() already merges render props + host props (host wins)\r\n        return renderFn(latest.current.props);\r\n    }\r\n\r\n    return {\r\n        resolve,\r\n        with: withOverrides,\r\n        Embed,\r\n        defaults,\r\n    };\r\n}"],"mappings":"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","names":[]}

package/dist/runtime/index.d.mts

@@ -0,0 +1,123 @@
+import * as ReactNS from 'react';
+import * as JsxRuntimeNS from 'react/jsx-runtime';
+
+type ReactLike = typeof ReactNS;
+type JsxRuntimeLike = typeof JsxRuntimeNS;
+type ImportMap = Record<string, any>;
+type CreateFactoryEnv = {
+    react: ReactLike;
+    jsxRuntime: JsxRuntimeLike;
+    /**
+     * Optional injected modules (merged into the import map).
+     * Example: { "@inertiajs/core": InertiaCore, "@host/ui": HostUI }
+     */
+    imports?: ImportMap;
+    /**
+     * Optional mapping of virtual IDs to CORS-safe ESM URLs for local dev.
+     * These URLs will be dynamically imported and added into the import map.
+     */
+    hostUrls?: Record<string, string>;
+    /**
+     * Optional base props coming from the host runtime / plugin caller.
+     * These props are **PRIORITY** and override any props passed to `render()`.
+     */
+    hostProps?: Record<string, any>;
+    /**
+     * Extra arbitrary values the host wants to pass into the factory deps object.
+     */
+    depsExtra?: Record<string, any>;
+};
+type CreateFactoryOptions = {
+    exportName?: string;
+    mode?: "auto" | "factory" | "component";
+    unwrapReturnedDefault?: boolean;
+    runtimeKey?: string;
+    tagKey?: string;
+    hostUrlsOverride?: boolean;
+};
+type PreparedRenderFactory<P = any> = ((props?: Partial<P>) => any) & {
+    component: any;
+    module: any;
+    exportName: string;
+    wasFactory: boolean;
+    file: string;
+    /**
+     * The final import map passed into the factory deps.
+     */
+    imports: ImportMap;
+    /**
+     * Host/base props attached to the renderer (priority).
+     */
+    hostProps: Record<string, any>;
+};
+/**
+ * Import `file` NOW, resolve the component export (default or named),
+ * then return a render factory you can call later with component props.
+ */
+declare function createFactory<P = any>(file: string, env: CreateFactoryEnv, opts?: CreateFactoryOptions, hostPropsOverride?: Partial<P>): Promise<PreparedRenderFactory<P>>;
+
+type CreateResolverConfig = {
+    env: CreateFactoryEnv;
+    options?: CreateFactoryOptions;
+    /**
+     * Base host props (priority) that should always be applied.
+     * These override any props passed to render().
+     */
+    hostProps?: Record<string, any>;
+};
+type ResolveOverrides = {
+    env?: Partial<CreateFactoryEnv>;
+    options?: Partial<CreateFactoryOptions>;
+    hostProps?: Record<string, any>;
+};
+type PluginResolver = {
+    /**
+     * Resolve a plugin entry (file URL/path) into a callable renderer.
+     * You can pass per-call overrides (e.g. inertia imports).
+     */
+    resolve<P = any>(file: string, overrides?: ResolveOverrides): Promise<PreparedRenderFactory<P>>;
+    /**
+     * Create a new resolver inheriting this resolver, with extra defaults.
+     * Great for adding inertia / host UI / dev URLs once, then reusing everywhere.
+     */
+    with(overrides: ResolveOverrides): PluginResolver;
+    /**
+     * A React component already bound to this resolver.
+     * Only needs `file` and props.
+     */
+    Embed: <P extends Record<string, any> = Record<string, any>>(props: EmbedProps<P>) => any;
+    /**
+     * Expose effective defaults (handy for debugging).
+     */
+    defaults: Required<CreateResolverConfig>;
+};
+type EmbedProps<P extends Record<string, any> = Record<string, any>> = {
+    file: string;
+    /**
+     * Default props (non-priority).
+     * Host props override these.
+     */
+    props?: Partial<P>;
+    /**
+     * Per-embed host props (priority).
+     * These override `props`.
+     */
+    hostProps?: Partial<P>;
+    /**
+     * Per-embed resolver overrides (env/options/hostProps).
+     * Useful when a specific plugin needs inertia, etc.
+     */
+    overrides?: ResolveOverrides;
+    fallback?: any;
+    onErrorRender?: (error: unknown) => any;
+    onResolved?: (info: {
+        file: string;
+        exportName: string;
+        wasFactory: boolean;
+        component: any;
+        module: any;
+    }) => void;
+};
+declare function createPluginResolver(config: CreateResolverConfig): PluginResolver;
+
+export { type CreateFactoryEnv, type CreateFactoryOptions, type CreateResolverConfig, type EmbedProps, type ImportMap, type JsxRuntimeLike, type PluginResolver, type PreparedRenderFactory, type ReactLike, type ResolveOverrides, createFactory, createPluginResolver };

package/dist/runtime/index.d.ts

@@ -0,0 +1,123 @@
+import * as ReactNS from 'react';
+import * as JsxRuntimeNS from 'react/jsx-runtime';
+
+type ReactLike = typeof ReactNS;
+type JsxRuntimeLike = typeof JsxRuntimeNS;
+type ImportMap = Record<string, any>;
+type CreateFactoryEnv = {
+    react: ReactLike;
+    jsxRuntime: JsxRuntimeLike;
+    /**
+     * Optional injected modules (merged into the import map).
+     * Example: { "@inertiajs/core": InertiaCore, "@host/ui": HostUI }
+     */
+    imports?: ImportMap;
+    /**
+     * Optional mapping of virtual IDs to CORS-safe ESM URLs for local dev.
+     * These URLs will be dynamically imported and added into the import map.
+     */
+    hostUrls?: Record<string, string>;
+    /**
+     * Optional base props coming from the host runtime / plugin caller.
+     * These props are **PRIORITY** and override any props passed to `render()`.
+     */
+    hostProps?: Record<string, any>;
+    /**
+     * Extra arbitrary values the host wants to pass into the factory deps object.
+     */
+    depsExtra?: Record<string, any>;
+};
+type CreateFactoryOptions = {
+    exportName?: string;
+    mode?: "auto" | "factory" | "component";
+    unwrapReturnedDefault?: boolean;
+    runtimeKey?: string;
+    tagKey?: string;
+    hostUrlsOverride?: boolean;
+};
+type PreparedRenderFactory<P = any> = ((props?: Partial<P>) => any) & {
+    component: any;
+    module: any;
+    exportName: string;
+    wasFactory: boolean;
+    file: string;
+    /**
+     * The final import map passed into the factory deps.
+     */
+    imports: ImportMap;
+    /**
+     * Host/base props attached to the renderer (priority).
+     */
+    hostProps: Record<string, any>;
+};
+/**
+ * Import `file` NOW, resolve the component export (default or named),
+ * then return a render factory you can call later with component props.
+ */
+declare function createFactory<P = any>(file: string, env: CreateFactoryEnv, opts?: CreateFactoryOptions, hostPropsOverride?: Partial<P>): Promise<PreparedRenderFactory<P>>;
+
+type CreateResolverConfig = {
+    env: CreateFactoryEnv;
+    options?: CreateFactoryOptions;
+    /**
+     * Base host props (priority) that should always be applied.
+     * These override any props passed to render().
+     */
+    hostProps?: Record<string, any>;
+};
+type ResolveOverrides = {
+    env?: Partial<CreateFactoryEnv>;
+    options?: Partial<CreateFactoryOptions>;
+    hostProps?: Record<string, any>;
+};
+type PluginResolver = {
+    /**
+     * Resolve a plugin entry (file URL/path) into a callable renderer.
+     * You can pass per-call overrides (e.g. inertia imports).
+     */
+    resolve<P = any>(file: string, overrides?: ResolveOverrides): Promise<PreparedRenderFactory<P>>;
+    /**
+     * Create a new resolver inheriting this resolver, with extra defaults.
+     * Great for adding inertia / host UI / dev URLs once, then reusing everywhere.
+     */
+    with(overrides: ResolveOverrides): PluginResolver;
+    /**
+     * A React component already bound to this resolver.
+     * Only needs `file` and props.
+     */
+    Embed: <P extends Record<string, any> = Record<string, any>>(props: EmbedProps<P>) => any;
+    /**
+     * Expose effective defaults (handy for debugging).
+     */
+    defaults: Required<CreateResolverConfig>;
+};
+type EmbedProps<P extends Record<string, any> = Record<string, any>> = {
+    file: string;
+    /**
+     * Default props (non-priority).
+     * Host props override these.
+     */
+    props?: Partial<P>;
+    /**
+     * Per-embed host props (priority).
+     * These override `props`.
+     */
+    hostProps?: Partial<P>;
+    /**
+     * Per-embed resolver overrides (env/options/hostProps).
+     * Useful when a specific plugin needs inertia, etc.
+     */
+    overrides?: ResolveOverrides;
+    fallback?: any;
+    onErrorRender?: (error: unknown) => any;
+    onResolved?: (info: {
+        file: string;
+        exportName: string;
+        wasFactory: boolean;
+        component: any;
+        module: any;
+    }) => void;
+};
+declare function createPluginResolver(config: CreateResolverConfig): PluginResolver;
+
+export { type CreateFactoryEnv, type CreateFactoryOptions, type CreateResolverConfig, type EmbedProps, type ImportMap, type JsxRuntimeLike, type PluginResolver, type PreparedRenderFactory, type ReactLike, type ResolveOverrides, createFactory, createPluginResolver };