@wordrhyme/plugin 0.1.0-alpha.10

package/dist/react.d.ts

@@ -0,0 +1,227 @@
+import React from 'react';
+import { W as WebSlotRemoteExtension, P as PluginMediaInfo } from './types-BJo3_91V.js';
+import { CurrencyInfo, FormatPriceOptions } from './globalization.js';
+import './release-BDJeO54k.js';
+import 'zod';
+import './time.js';
+import 'decimal.js';
+import './locale.js';
+
+/**
+ * React utilities for plugin admin UIs.
+ *
+ * At runtime, this module is shared via Module Federation from the admin host.
+ * Plugins should configure MF shared with `import: false` for this package.
+ */
+
+/**
+ * Called by the Admin Host at startup to inject the host's tRPC React client.
+ * Plugin code should NOT call this directly.
+ * @internal
+ */
+declare function __setTrpc(trpc: any): void;
+/**
+ * Hook for plugin components to access their tRPC namespace with React Query hooks.
+ * Must be called within a component rendered inside the Admin Host.
+ *
+ * @param pluginId - Short plugin ID (e.g., 'storage-s3') or full ID (e.g., 'com.wordrhyme.storage-s3')
+ * @returns tRPC proxy with useQuery/useMutation hooks
+ *
+ * @example
+ * ```tsx
+ * import { usePluginTrpc } from '@wordrhyme/plugin/react';
+ *
+ * function MyPluginPage() {
+ *     const api = usePluginTrpc('my-plugin');
+ *     const { data, isLoading } = api.listItems.useQuery();
+ *     const createItem = api.createItem.useMutation();
+ * }
+ * ```
+ */
+declare function usePluginTrpc(pluginId: string): any;
+/**
+ * Hook for plugin components to access the Admin Host's root tRPC React client.
+ * Useful for shared host capabilities such as currency, media, auth, etc.
+ */
+declare function useHostTrpc(): any;
+interface PluginI18nValue {
+    pluginId?: string | undefined;
+    namespace?: string | undefined;
+    locale: string;
+    timezone: string;
+    isLoading: boolean;
+    availableLocales: readonly string[];
+    languages: readonly PluginLanguageOption[];
+    t: (key: string, paramsOrDefault?: Record<string, string | number> | string) => string;
+    /** Host-bound Core common translator. Optional for compatibility with older Hosts. */
+    tCommon?: (key: string, paramsOrDefault?: Record<string, string | number> | string) => string;
+    addNamespace: (namespace: string) => void;
+}
+interface PluginLanguageOption {
+    locale: string;
+    name: string;
+    nativeName: string;
+    direction: 'ltr' | 'rtl';
+    isDefault: boolean;
+    sortOrder: number;
+}
+declare const PluginI18nContext: React.Context<PluginI18nValue>;
+declare function usePluginTranslation(pluginId: string, customNamespace?: string): {
+    t: (key: string, paramsOrDefault?: Record<string, string | number> | string) => string;
+    tCommon: (key: string, paramsOrDefault?: Record<string, string | number> | string) => string;
+    locale: string;
+    timezone: string;
+    isLoading: boolean;
+    availableLocales: readonly string[];
+    languages: readonly PluginLanguageOption[];
+    namespace: string;
+};
+/** Currency capabilities exposed by the Admin Host to plugin UIs. */
+interface PluginCurrencyValue {
+    currency: CurrencyInfo;
+    currencies: CurrencyInfo[];
+    baseCurrency: CurrencyInfo;
+    isLoading: boolean;
+    isReady: boolean;
+    changeCurrency: (currencyCode: string) => void;
+    formatPrice: (cents: number, fromCurrency?: string | undefined, options?: FormatPriceOptions | undefined) => string;
+}
+declare const PluginCurrencyContext: React.Context<PluginCurrencyValue>;
+declare function usePluginCurrency(): PluginCurrencyValue;
+interface PluginSlotProps {
+    /** Slot name, e.g. 'shop.product.detail.actions' */
+    name: string;
+    /** React props passed to extensions rendered in this slot */
+    props?: Record<string, unknown>;
+    /** @deprecated Use props. Kept for legacy plugin slot call sites. */
+    context?: Record<string, unknown>;
+    /** Layout mode */
+    layout?: 'inline' | 'stack' | 'tabs' | 'grid';
+    /** Additional CSS class */
+    className?: string;
+    /** Fallback when no extensions registered */
+    fallback?: React.ReactNode;
+}
+interface PluginSlotRegistry {
+    /** Returns whether at least one extension is registered for the slot. */
+    has: (name: string) => boolean;
+    /** Subscribes to extension registry changes. */
+    subscribe: (onStoreChange: () => void) => () => void;
+}
+/**
+ * Called by the Admin Host at startup to inject the PluginSlot component.
+ * Plugin code should NOT call this directly.
+ * @internal
+ */
+declare function __setPluginSlot(component: React.ComponentType<PluginSlotProps>): void;
+/**
+ * Called by the Admin Host at startup to expose reactive slot availability.
+ * Plugin code should NOT call this directly.
+ * @internal
+ */
+declare function __setPluginSlotRegistry(registry: PluginSlotRegistry | null): void;
+/**
+ * Returns whether the given slot currently has at least one registered extension.
+ * The value updates when plugins are registered, reloaded, disabled, or removed.
+ */
+declare function usePluginSlot(name: string): boolean;
+/**
+ * Renders all plugin extensions registered for the given slot.
+ *
+ * @example
+ * ```tsx
+ * import { PluginSlot } from '@wordrhyme/plugin/react';
+ *
+ * function ProductDetailPage({ productId }) {
+ *     return (
+ *         <div>
+ *             <h1>Product Detail</h1>
+ *             <PluginSlot
+ *                 name="shop.product.detail.actions"
+ *                 layout="inline"
+ *                 props={{ productId }}
+ *             />
+ *         </div>
+ *     );
+ * }
+ * ```
+ */
+declare function PluginSlot(props: PluginSlotProps): React.ReactElement | null;
+type WebPluginSlotLayout = 'bare' | 'inline' | 'stack' | 'grid';
+interface WebPluginSlotRenderOptions {
+    name: string;
+    extensions: WebSlotRemoteExtension[];
+    props?: Record<string, unknown> | undefined;
+    layout?: WebPluginSlotLayout | undefined;
+}
+interface PublicWebPluginRuntime {
+    scan: (root?: ParentNode) => void;
+    renderSlot: (mount: HTMLElement, options: WebPluginSlotRenderOptions) => void;
+    unmountSlot: (mount: HTMLElement) => void;
+}
+declare const PUBLIC_PLUGIN_RUNTIME_READY_EVENT = "wr:public-plugin-runtime-ready";
+declare global {
+    interface Window {
+        __WR_PUBLIC_PLUGIN_RUNTIME__?: PublicWebPluginRuntime;
+    }
+}
+interface WebPluginSlotProps extends WebPluginSlotRenderOptions {
+    className?: string | undefined;
+}
+/**
+ * Declares a public-web plugin slot inside an owning React tree.
+ *
+ * The owner keeps control of live props and React lifecycle. The Web Host owns
+ * remote loading and renders extensions into the empty mount element through
+ * its shared Module Federation React runtime.
+ */
+declare function WebPluginSlot({ name, extensions, props, layout, className, }: WebPluginSlotProps): React.ReactElement | null;
+/**
+ * Minimal ability interface for plugin permission checks.
+ * Matches CASL MongoAbility.can() signature.
+ */
+interface PluginAbility {
+    can(action: string, subject: string): boolean;
+}
+/**
+ * React Context for ability — shared between host and plugins.
+ * Host injects via AbilityBridge, plugins consume via usePluginAbility.
+ */
+declare const PluginAbilityContext: React.Context<PluginAbility>;
+/**
+ * Hook for plugin components to check permissions.
+ *
+ * @example
+ * ```tsx
+ * import { usePluginAbility } from '@wordrhyme/plugin/react';
+ *
+ * function MyPluginPage() {
+ *     const ability = usePluginAbility();
+ *     const canCreate = ability.can('create', 'PluginResource');
+ *     const canDelete = ability.can('delete', 'PluginResource');
+ * }
+ * ```
+ */
+declare function usePluginAbility(): PluginAbility;
+
+interface MediaPickerOptions {
+    presentation?: 'dialog' | 'drawer';
+    mode?: 'single' | 'multi';
+    category?: 'all' | 'image' | 'document' | 'video' | 'audio' | 'archive' | 'other';
+    /** Allow callers to select an external image by entering its URL in the picker. */
+    allowExternalUrl?: boolean;
+    /** Prefer importing URL images into Media, or only allow a transient external reference. */
+    externalUrlMode?: 'import-preferred' | 'reference-only';
+    /** Publish selected images when needed and include an absolute public URL in each result. */
+    requirePublicUrl?: boolean;
+    onSelect: (media: PluginMediaInfo[]) => void;
+}
+/**
+ * Hook to open the global Media Picker dialog (rendered by Admin Host).
+ * Returns an imperative API `openDialog(options)`.
+ */
+declare function useMediaPicker(): {
+    openDialog: (options: MediaPickerOptions) => void;
+};
+
+export { type MediaPickerOptions, PUBLIC_PLUGIN_RUNTIME_READY_EVENT, type PluginAbility, PluginAbilityContext, PluginCurrencyContext, type PluginCurrencyValue, PluginI18nContext, type PluginI18nValue, type PluginLanguageOption, PluginSlot, type PluginSlotProps, type PluginSlotRegistry, type PublicWebPluginRuntime, WebPluginSlot, type WebPluginSlotLayout, type WebPluginSlotProps, type WebPluginSlotRenderOptions, __setPluginSlot, __setPluginSlotRegistry, __setTrpc, useHostTrpc, useMediaPicker, usePluginAbility, usePluginCurrency, usePluginSlot, usePluginTranslation, usePluginTrpc };

package/dist/react.js

@@ -0,0 +1,226 @@
+import {
+  DEFAULT_CURRENCY
+} from "./chunk-BVOTSKM2.js";
+import "./chunk-BI7E5CVM.js";
+
+// src/react.ts
+import React from "react";
+var _trpc = null;
+var _hostTrpcFacade = null;
+function __setTrpc(trpc) {
+  _trpc = trpc;
+  _hostTrpcFacade = null;
+}
+function usePluginTrpc(pluginId) {
+  if (!_trpc) {
+    throw new Error(
+      "[plugin/react] tRPC not initialized. Ensure plugin is loaded within Admin Host context."
+    );
+  }
+  const normalizedId = pluginId.replace(/^com\.wordrhyme\./, "").replace(/\./g, "-");
+  return _trpc.pluginApis[normalizedId];
+}
+function useHostTrpc() {
+  if (!_trpc) {
+    throw new Error(
+      "[plugin/react] tRPC not initialized. Ensure plugin is loaded within Admin Host context."
+    );
+  }
+  if (!_hostTrpcFacade) {
+    _hostTrpcFacade = new Proxy(_trpc, {
+      get(target, property, receiver) {
+        if (property === "i18n") {
+          throw new Error(
+            "[plugin/react] Host i18n APIs are not exposed to plugins. Use the Host-bound usePluginTranslation() bridge."
+          );
+        }
+        return Reflect.get(target, property, receiver);
+      },
+      has(target, property) {
+        return property === "i18n" ? false : Reflect.has(target, property);
+      },
+      ownKeys(target) {
+        return Reflect.ownKeys(target).filter((property) => property !== "i18n");
+      }
+    });
+  }
+  return _hostTrpcFacade;
+}
+var fallbackPluginTranslate = (key, paramsOrDefault) => typeof paramsOrDefault === "string" ? paramsOrDefault : key;
+var defaultI18n = {
+  locale: "en-US",
+  timezone: "UTC",
+  isLoading: false,
+  availableLocales: [],
+  languages: [],
+  t: fallbackPluginTranslate,
+  tCommon: fallbackPluginTranslate,
+  addNamespace: () => void 0
+};
+var PluginI18nContext = React.createContext(defaultI18n);
+function normalizePluginNamespace(pluginId) {
+  return `plugin.${pluginId}`;
+}
+function usePluginTranslation(pluginId, customNamespace) {
+  const i18n = React.useContext(PluginI18nContext);
+  if (!i18n.pluginId || !i18n.namespace) {
+    throw new Error("[plugin/react] Plugin i18n boundary is missing");
+  }
+  if (pluginId !== i18n.pluginId) {
+    throw new Error(
+      `[plugin/react] Plugin i18n identity mismatch: expected ${i18n.pluginId}, received ${pluginId}`
+    );
+  }
+  const namespace = normalizePluginNamespace(pluginId);
+  if (customNamespace && customNamespace !== namespace) {
+    throw new Error(
+      `[plugin/react] Plugin namespace mismatch: expected ${namespace}, received ${customNamespace}`
+    );
+  }
+  if (i18n.namespace !== namespace) {
+    throw new Error(
+      `[plugin/react] Host-bound namespace mismatch: expected ${namespace}, received ${i18n.namespace}`
+    );
+  }
+  const t = React.useCallback(
+    (key, paramsOrDefault) => {
+      const prefix = `${namespace}.`;
+      const localKey = key.startsWith(prefix) ? key.slice(prefix.length) : key;
+      return i18n.t(localKey, paramsOrDefault);
+    },
+    [i18n]
+  );
+  const tCommon = i18n.tCommon ?? fallbackPluginTranslate;
+  return React.useMemo(
+    () => ({
+      t,
+      tCommon,
+      locale: i18n.locale,
+      timezone: i18n.timezone,
+      isLoading: i18n.isLoading,
+      availableLocales: i18n.availableLocales,
+      languages: i18n.languages,
+      namespace
+    }),
+    [
+      t,
+      tCommon,
+      i18n.locale,
+      i18n.timezone,
+      i18n.isLoading,
+      i18n.availableLocales,
+      i18n.languages,
+      namespace
+    ]
+  );
+}
+var defaultPluginCurrency = {
+  currency: DEFAULT_CURRENCY,
+  currencies: [],
+  baseCurrency: DEFAULT_CURRENCY,
+  isLoading: false,
+  isReady: false,
+  changeCurrency: () => void 0,
+  formatPrice: (cents, fromCurrency) => `${fromCurrency ?? DEFAULT_CURRENCY.code} ${(cents / 100).toFixed(2)}`
+};
+var PluginCurrencyContext = React.createContext(defaultPluginCurrency);
+function usePluginCurrency() {
+  return React.useContext(PluginCurrencyContext);
+}
+var _PluginSlotImpl = null;
+var _pluginSlotRegistry = null;
+var emptyPluginSlotSubscribe = () => () => void 0;
+function __setPluginSlot(component) {
+  _PluginSlotImpl = component;
+}
+function __setPluginSlotRegistry(registry) {
+  _pluginSlotRegistry = registry;
+}
+function usePluginSlot(name) {
+  const getSnapshot = () => _pluginSlotRegistry?.has(name) ?? false;
+  return React.useSyncExternalStore(
+    _pluginSlotRegistry?.subscribe ?? emptyPluginSlotSubscribe,
+    getSnapshot,
+    getSnapshot
+  );
+}
+function PluginSlot(props) {
+  if (!_PluginSlotImpl) {
+    return null;
+  }
+  return React.createElement(_PluginSlotImpl, props);
+}
+var PUBLIC_PLUGIN_RUNTIME_READY_EVENT = "wr:public-plugin-runtime-ready";
+function WebPluginSlot({
+  name,
+  extensions,
+  props,
+  layout = "bare",
+  className
+}) {
+  const mountRef = React.useRef(null);
+  const latestRef = React.useRef({ name, extensions, props, layout });
+  latestRef.current = { name, extensions, props, layout };
+  const renderCurrent = React.useCallback(() => {
+    const mount = mountRef.current;
+    const runtime = typeof window === "undefined" ? void 0 : window.__WR_PUBLIC_PLUGIN_RUNTIME__;
+    if (!mount || !runtime) return;
+    runtime.renderSlot(mount, latestRef.current);
+  }, []);
+  React.useEffect(() => {
+    if (typeof window === "undefined") return void 0;
+    const mount = mountRef.current;
+    window.addEventListener(PUBLIC_PLUGIN_RUNTIME_READY_EVENT, renderCurrent);
+    return () => {
+      window.removeEventListener(PUBLIC_PLUGIN_RUNTIME_READY_EVENT, renderCurrent);
+      if (mount) window.__WR_PUBLIC_PLUGIN_RUNTIME__?.unmountSlot(mount);
+    };
+  }, [renderCurrent]);
+  React.useEffect(() => {
+    renderCurrent();
+  });
+  if (extensions.length === 0) return null;
+  return React.createElement("div", {
+    ref: mountRef,
+    className,
+    "data-wr-plugin-react-slot": name
+  });
+}
+var defaultAbility = { can: () => true };
+var PluginAbilityContext = React.createContext(defaultAbility);
+function usePluginAbility() {
+  return React.useContext(PluginAbilityContext);
+}
+function useMediaPicker() {
+  return {
+    openDialog: (options) => {
+      if (typeof window !== "undefined") {
+        const picker = window.__WORDRHYME_MEDIA_PICKER__ || window.__OMNIDS_MEDIA_PICKER__;
+        if (picker) {
+          picker.open(options);
+          return;
+        }
+      }
+      console.warn("[plugin/react] Media Picker is not mounted by the Admin Host.");
+    }
+  };
+}
+export {
+  PUBLIC_PLUGIN_RUNTIME_READY_EVENT,
+  PluginAbilityContext,
+  PluginCurrencyContext,
+  PluginI18nContext,
+  PluginSlot,
+  WebPluginSlot,
+  __setPluginSlot,
+  __setPluginSlotRegistry,
+  __setTrpc,
+  useHostTrpc,
+  useMediaPicker,
+  usePluginAbility,
+  usePluginCurrency,
+  usePluginSlot,
+  usePluginTranslation,
+  usePluginTrpc
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.ts"],"sourcesContent":["/// <reference lib=\"dom\" />\n\n/**\n * React utilities for plugin admin UIs.\n *\n * At runtime, this module is shared via Module Federation from the admin host.\n * Plugins should configure MF shared with `import: false` for this package.\n */\nimport React from 'react';\nimport type { WebSlotRemoteExtension } from './types';\nimport {\n    DEFAULT_CURRENCY,\n    type CurrencyInfo,\n    type FormatPriceOptions,\n} from './globalization';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet _trpc: any = null;\nlet _hostTrpcFacade: any = null;\n\n/**\n * Called by the Admin Host at startup to inject the host's tRPC React client.\n * Plugin code should NOT call this directly.\n * @internal\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function __setTrpc(trpc: any) {\n    _trpc = trpc;\n    _hostTrpcFacade = null;\n}\n\n/**\n * Hook for plugin components to access their tRPC namespace with React Query hooks.\n * Must be called within a component rendered inside the Admin Host.\n *\n * @param pluginId - Short plugin ID (e.g., 'storage-s3') or full ID (e.g., 'com.wordrhyme.storage-s3')\n * @returns tRPC proxy with useQuery/useMutation hooks\n *\n * @example\n * ```tsx\n * import { usePluginTrpc } from '@wordrhyme/plugin/react';\n *\n * function MyPluginPage() {\n *     const api = usePluginTrpc('my-plugin');\n *     const { data, isLoading } = api.listItems.useQuery();\n *     const createItem = api.createItem.useMutation();\n * }\n * ```\n */\nexport function usePluginTrpc(pluginId: string) {\n    if (!_trpc) {\n        throw new Error(\n            '[plugin/react] tRPC not initialized. ' +\n            'Ensure plugin is loaded within Admin Host context.',\n        );\n    }\n    const normalizedId = pluginId\n        .replace(/^com\\.wordrhyme\\./, '')\n        .replace(/\\./g, '-');\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (_trpc as any).pluginApis[normalizedId];\n}\n\n/**\n * Hook for plugin components to access the Admin Host's root tRPC React client.\n * Useful for shared host capabilities such as currency, media, auth, etc.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useHostTrpc(): any {\n    if (!_trpc) {\n        throw new Error(\n            '[plugin/react] tRPC not initialized. ' +\n            'Ensure plugin is loaded within Admin Host context.',\n        );\n    }\n    if (!_hostTrpcFacade) {\n        _hostTrpcFacade = new Proxy(_trpc, {\n            get(target, property, receiver) {\n                if (property === 'i18n') {\n                    throw new Error(\n                        '[plugin/react] Host i18n APIs are not exposed to plugins. ' +\n                        'Use the Host-bound usePluginTranslation() bridge.',\n                    );\n                }\n                return Reflect.get(target, property, receiver);\n            },\n            has(target, property) {\n                return property === 'i18n' ? false : Reflect.has(target, property);\n            },\n            ownKeys(target) {\n                return Reflect.ownKeys(target).filter((property) => property !== 'i18n');\n            },\n        });\n    }\n    return _hostTrpcFacade;\n}\n\n// ============================================================\n// I18n — host translation bridge\n// ============================================================\n\nexport interface PluginI18nValue {\n    pluginId?: string | undefined;\n    namespace?: string | undefined;\n    locale: string;\n    timezone: string;\n    isLoading: boolean;\n    availableLocales: readonly string[];\n    languages: readonly PluginLanguageOption[];\n    t: (key: string, paramsOrDefault?: Record<string, string | number> | string) => string;\n    /** Host-bound Core common translator. Optional for compatibility with older Hosts. */\n    tCommon?: (key: string, paramsOrDefault?: Record<string, string | number> | string) => string;\n    addNamespace: (namespace: string) => void;\n}\n\nexport interface PluginLanguageOption {\n    locale: string;\n    name: string;\n    nativeName: string;\n    direction: 'ltr' | 'rtl';\n    isDefault: boolean;\n    sortOrder: number;\n}\n\nconst fallbackPluginTranslate = (\n    key: string,\n    paramsOrDefault?: Record<string, string | number> | string,\n) => (typeof paramsOrDefault === 'string' ? paramsOrDefault : key);\n\nconst defaultI18n: PluginI18nValue = {\n    locale: 'en-US',\n    timezone: 'UTC',\n    isLoading: false,\n    availableLocales: [],\n    languages: [],\n    t: fallbackPluginTranslate,\n    tCommon: fallbackPluginTranslate,\n    addNamespace: () => undefined,\n};\n\nexport const PluginI18nContext = React.createContext<PluginI18nValue>(defaultI18n);\n\nfunction normalizePluginNamespace(pluginId: string): string {\n    return `plugin.${pluginId}`;\n}\n\nexport function usePluginTranslation(pluginId: string, customNamespace?: string) {\n    const i18n = React.useContext(PluginI18nContext);\n    if (!i18n.pluginId || !i18n.namespace) {\n        throw new Error('[plugin/react] Plugin i18n boundary is missing');\n    }\n    if (pluginId !== i18n.pluginId) {\n        throw new Error(\n            `[plugin/react] Plugin i18n identity mismatch: expected ${i18n.pluginId}, received ${pluginId}`,\n        );\n    }\n    const namespace = normalizePluginNamespace(pluginId);\n    if (customNamespace && customNamespace !== namespace) {\n        throw new Error(\n            `[plugin/react] Plugin namespace mismatch: expected ${namespace}, received ${customNamespace}`,\n        );\n    }\n    if (i18n.namespace !== namespace) {\n        throw new Error(\n            `[plugin/react] Host-bound namespace mismatch: expected ${namespace}, received ${i18n.namespace}`,\n        );\n    }\n\n    const t = React.useCallback(\n        (key: string, paramsOrDefault?: Record<string, string | number> | string): string => {\n            const prefix = `${namespace}.`;\n            const localKey = key.startsWith(prefix) ? key.slice(prefix.length) : key;\n            return i18n.t(localKey, paramsOrDefault);\n        },\n        [i18n],\n    );\n    const tCommon = i18n.tCommon ?? fallbackPluginTranslate;\n\n    return React.useMemo(\n        () => ({\n            t,\n            tCommon,\n            locale: i18n.locale,\n            timezone: i18n.timezone,\n            isLoading: i18n.isLoading,\n            availableLocales: i18n.availableLocales,\n            languages: i18n.languages,\n            namespace,\n        }),\n        [\n            t,\n            tCommon,\n            i18n.locale,\n            i18n.timezone,\n            i18n.isLoading,\n            i18n.availableLocales,\n            i18n.languages,\n            namespace,\n        ],\n    );\n}\n\n// ============================================================\n// Currency — host currency bridge\n// ============================================================\n\n/** Currency capabilities exposed by the Admin Host to plugin UIs. */\nexport interface PluginCurrencyValue {\n    currency: CurrencyInfo;\n    currencies: CurrencyInfo[];\n    baseCurrency: CurrencyInfo;\n    isLoading: boolean;\n    isReady: boolean;\n    changeCurrency: (currencyCode: string) => void;\n    formatPrice: (\n        cents: number,\n        fromCurrency?: string | undefined,\n        options?: FormatPriceOptions | undefined,\n    ) => string;\n}\n\nconst defaultPluginCurrency: PluginCurrencyValue = {\n    currency: DEFAULT_CURRENCY,\n    currencies: [],\n    baseCurrency: DEFAULT_CURRENCY,\n    isLoading: false,\n    isReady: false,\n    changeCurrency: () => undefined,\n    formatPrice: (cents, fromCurrency) => `${fromCurrency ?? DEFAULT_CURRENCY.code} ${(cents / 100).toFixed(2)}`,\n};\n\nexport const PluginCurrencyContext = React.createContext<PluginCurrencyValue>(defaultPluginCurrency);\n\nexport function usePluginCurrency(): PluginCurrencyValue {\n    return React.useContext(PluginCurrencyContext);\n}\n\n// ============================================================\n// PluginSlot — runtime-injected from Admin Host\n// ============================================================\n\nexport interface PluginSlotProps {\n    /** Slot name, e.g. 'shop.product.detail.actions' */\n    name: string;\n    /** React props passed to extensions rendered in this slot */\n    props?: Record<string, unknown>;\n    /** @deprecated Use props. Kept for legacy plugin slot call sites. */\n    context?: Record<string, unknown>;\n    /** Layout mode */\n    layout?: 'inline' | 'stack' | 'tabs' | 'grid';\n    /** Additional CSS class */\n    className?: string;\n    /** Fallback when no extensions registered */\n    fallback?: React.ReactNode;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet _PluginSlotImpl: React.ComponentType<PluginSlotProps> | null = null;\n\nexport interface PluginSlotRegistry {\n    /** Returns whether at least one extension is registered for the slot. */\n    has: (name: string) => boolean;\n    /** Subscribes to extension registry changes. */\n    subscribe: (onStoreChange: () => void) => () => void;\n}\n\nlet _pluginSlotRegistry: PluginSlotRegistry | null = null;\nconst emptyPluginSlotSubscribe = () => () => undefined;\n\n/**\n * Called by the Admin Host at startup to inject the PluginSlot component.\n * Plugin code should NOT call this directly.\n * @internal\n */\nexport function __setPluginSlot(component: React.ComponentType<PluginSlotProps>) {\n    _PluginSlotImpl = component;\n}\n\n/**\n * Called by the Admin Host at startup to expose reactive slot availability.\n * Plugin code should NOT call this directly.\n * @internal\n */\nexport function __setPluginSlotRegistry(registry: PluginSlotRegistry | null) {\n    _pluginSlotRegistry = registry;\n}\n\n/**\n * Returns whether the given slot currently has at least one registered extension.\n * The value updates when plugins are registered, reloaded, disabled, or removed.\n */\nexport function usePluginSlot(name: string): boolean {\n    const getSnapshot = () => _pluginSlotRegistry?.has(name) ?? false;\n\n    return React.useSyncExternalStore(\n        _pluginSlotRegistry?.subscribe ?? emptyPluginSlotSubscribe,\n        getSnapshot,\n        getSnapshot,\n    );\n}\n\n/**\n * Renders all plugin extensions registered for the given slot.\n *\n * @example\n * ```tsx\n * import { PluginSlot } from '@wordrhyme/plugin/react';\n *\n * function ProductDetailPage({ productId }) {\n *     return (\n *         <div>\n *             <h1>Product Detail</h1>\n *             <PluginSlot\n *                 name=\"shop.product.detail.actions\"\n *                 layout=\"inline\"\n *                 props={{ productId }}\n *             />\n *         </div>\n *     );\n * }\n * ```\n */\nexport function PluginSlot(props: PluginSlotProps): React.ReactElement | null {\n    if (!_PluginSlotImpl) {\n        // Silently render nothing if host hasn't injected yet\n        return null;\n    }\n    return React.createElement(_PluginSlotImpl, props);\n}\n\n// ============================================================\n// WebPluginSlot — declarative public-web React slot bridge\n// ============================================================\n\nexport type WebPluginSlotLayout = 'bare' | 'inline' | 'stack' | 'grid';\n\nexport interface WebPluginSlotRenderOptions {\n    name: string;\n    extensions: WebSlotRemoteExtension[];\n    props?: Record<string, unknown> | undefined;\n    layout?: WebPluginSlotLayout | undefined;\n}\n\nexport interface PublicWebPluginRuntime {\n    scan: (root?: ParentNode) => void;\n    renderSlot: (mount: HTMLElement, options: WebPluginSlotRenderOptions) => void;\n    unmountSlot: (mount: HTMLElement) => void;\n}\n\nexport const PUBLIC_PLUGIN_RUNTIME_READY_EVENT = 'wr:public-plugin-runtime-ready';\n\ndeclare global {\n    interface Window {\n        __WR_PUBLIC_PLUGIN_RUNTIME__?: PublicWebPluginRuntime;\n    }\n}\n\nexport interface WebPluginSlotProps extends WebPluginSlotRenderOptions {\n    className?: string | undefined;\n}\n\n/**\n * Declares a public-web plugin slot inside an owning React tree.\n *\n * The owner keeps control of live props and React lifecycle. The Web Host owns\n * remote loading and renders extensions into the empty mount element through\n * its shared Module Federation React runtime.\n */\nexport function WebPluginSlot({\n    name,\n    extensions,\n    props,\n    layout = 'bare',\n    className,\n}: WebPluginSlotProps): React.ReactElement | null {\n    const mountRef = React.useRef<HTMLDivElement>(null);\n    const latestRef = React.useRef<WebPluginSlotRenderOptions>({ name, extensions, props, layout });\n    latestRef.current = { name, extensions, props, layout };\n\n    const renderCurrent = React.useCallback(() => {\n        const mount = mountRef.current;\n        const runtime = typeof window === 'undefined' ? undefined : window.__WR_PUBLIC_PLUGIN_RUNTIME__;\n        if (!mount || !runtime) return;\n        runtime.renderSlot(mount, latestRef.current);\n    }, []);\n\n    React.useEffect(() => {\n        if (typeof window === 'undefined') return undefined;\n        const mount = mountRef.current;\n        window.addEventListener(PUBLIC_PLUGIN_RUNTIME_READY_EVENT, renderCurrent);\n        return () => {\n            window.removeEventListener(PUBLIC_PLUGIN_RUNTIME_READY_EVENT, renderCurrent);\n            if (mount) window.__WR_PUBLIC_PLUGIN_RUNTIME__?.unmountSlot(mount);\n        };\n    }, [renderCurrent]);\n\n    React.useEffect(() => {\n        renderCurrent();\n    });\n\n    if (extensions.length === 0) return null;\n\n    return React.createElement('div', {\n        ref: mountRef,\n        className,\n        'data-wr-plugin-react-slot': name,\n    });\n}\n\n// Ability — runtime-injected from Admin Host (CASL permission)\n// ============================================================\n\n/**\n * Minimal ability interface for plugin permission checks.\n * Matches CASL MongoAbility.can() signature.\n */\nexport interface PluginAbility {\n    can(action: string, subject: string): boolean;\n}\n\n/** Default allow-all ability (when host hasn't injected) */\nconst defaultAbility: PluginAbility = { can: () => true };\n\n/**\n * React Context for ability — shared between host and plugins.\n * Host injects via AbilityBridge, plugins consume via usePluginAbility.\n */\nexport const PluginAbilityContext = React.createContext<PluginAbility>(defaultAbility);\n\n/**\n * Hook for plugin components to check permissions.\n *\n * @example\n * ```tsx\n * import { usePluginAbility } from '@wordrhyme/plugin/react';\n *\n * function MyPluginPage() {\n *     const ability = usePluginAbility();\n *     const canCreate = ability.can('create', 'PluginResource');\n *     const canDelete = ability.can('delete', 'PluginResource');\n * }\n * ```\n */\nexport function usePluginAbility(): PluginAbility {\n    return React.useContext(PluginAbilityContext);\n}\n\n// ============================================================\n// Media Picker — accesses global imperative API\n// ============================================================\n\nimport type { PluginMediaInfo } from './types';\n\n// Define the options for the global MediaPicker\nexport interface MediaPickerOptions {\n  presentation?: 'dialog' | 'drawer'; // Where to open the picker\n  mode?: 'single' | 'multi';\n  category?: 'all' | 'image' | 'document' | 'video' | 'audio' | 'archive' | 'other';\n  /** Allow callers to select an external image by entering its URL in the picker. */\n  allowExternalUrl?: boolean;\n  /** Prefer importing URL images into Media, or only allow a transient external reference. */\n  externalUrlMode?: 'import-preferred' | 'reference-only';\n  /** Publish selected images when needed and include an absolute public URL in each result. */\n  requirePublicUrl?: boolean;\n  onSelect: (media: PluginMediaInfo[]) => void;\n}\n\n/**\n * Hook to open the global Media Picker dialog (rendered by Admin Host).\n * Returns an imperative API `openDialog(options)`.\n */\nexport function useMediaPicker() {\n    return {\n        openDialog: (options: MediaPickerOptions) => {\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            // @ts-ignore\n            if (typeof window !== 'undefined') {\n                // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n                // @ts-ignore\n                const picker = window.__WORDRHYME_MEDIA_PICKER__ || window.__OMNIDS_MEDIA_PICKER__;\n                if (picker) {\n                    picker.open(options);\n                    return;\n                }\n            }\n            console.warn('[plugin/react] Media Picker is not mounted by the Admin Host.');\n        }\n    };\n}\n"],"mappings":";;;;;;AAQA,OAAO,WAAW;AASlB,IAAI,QAAa;AACjB,IAAI,kBAAuB;AAQpB,SAAS,UAAU,MAAW;AACjC,UAAQ;AACR,oBAAkB;AACtB;AAoBO,SAAS,cAAc,UAAkB;AAC5C,MAAI,CAAC,OAAO;AACR,UAAM,IAAI;AAAA,MACN;AAAA,IAEJ;AAAA,EACJ;AACA,QAAM,eAAe,SAChB,QAAQ,qBAAqB,EAAE,EAC/B,QAAQ,OAAO,GAAG;AAEvB,SAAQ,MAAc,WAAW,YAAY;AACjD;AAOO,SAAS,cAAmB;AAC/B,MAAI,CAAC,OAAO;AACR,UAAM,IAAI;AAAA,MACN;AAAA,IAEJ;AAAA,EACJ;AACA,MAAI,CAAC,iBAAiB;AAClB,sBAAkB,IAAI,MAAM,OAAO;AAAA,MAC/B,IAAI,QAAQ,UAAU,UAAU;AAC5B,YAAI,aAAa,QAAQ;AACrB,gBAAM,IAAI;AAAA,YACN;AAAA,UAEJ;AAAA,QACJ;AACA,eAAO,QAAQ,IAAI,QAAQ,UAAU,QAAQ;AAAA,MACjD;AAAA,MACA,IAAI,QAAQ,UAAU;AAClB,eAAO,aAAa,SAAS,QAAQ,QAAQ,IAAI,QAAQ,QAAQ;AAAA,MACrE;AAAA,MACA,QAAQ,QAAQ;AACZ,eAAO,QAAQ,QAAQ,MAAM,EAAE,OAAO,CAAC,aAAa,aAAa,MAAM;AAAA,MAC3E;AAAA,IACJ,CAAC;AAAA,EACL;AACA,SAAO;AACX;AA6BA,IAAM,0BAA0B,CAC5B,KACA,oBACE,OAAO,oBAAoB,WAAW,kBAAkB;AAE9D,IAAM,cAA+B;AAAA,EACjC,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,WAAW;AAAA,EACX,kBAAkB,CAAC;AAAA,EACnB,WAAW,CAAC;AAAA,EACZ,GAAG;AAAA,EACH,SAAS;AAAA,EACT,cAAc,MAAM;AACxB;AAEO,IAAM,oBAAoB,MAAM,cAA+B,WAAW;AAEjF,SAAS,yBAAyB,UAA0B;AACxD,SAAO,UAAU,QAAQ;AAC7B;AAEO,SAAS,qBAAqB,UAAkB,iBAA0B;AAC7E,QAAM,OAAO,MAAM,WAAW,iBAAiB;AAC/C,MAAI,CAAC,KAAK,YAAY,CAAC,KAAK,WAAW;AACnC,UAAM,IAAI,MAAM,gDAAgD;AAAA,EACpE;AACA,MAAI,aAAa,KAAK,UAAU;AAC5B,UAAM,IAAI;AAAA,MACN,0DAA0D,KAAK,QAAQ,cAAc,QAAQ;AAAA,IACjG;AAAA,EACJ;AACA,QAAM,YAAY,yBAAyB,QAAQ;AACnD,MAAI,mBAAmB,oBAAoB,WAAW;AAClD,UAAM,IAAI;AAAA,MACN,sDAAsD,SAAS,cAAc,eAAe;AAAA,IAChG;AAAA,EACJ;AACA,MAAI,KAAK,cAAc,WAAW;AAC9B,UAAM,IAAI;AAAA,MACN,0DAA0D,SAAS,cAAc,KAAK,SAAS;AAAA,IACnG;AAAA,EACJ;AAEA,QAAM,IAAI,MAAM;AAAA,IACZ,CAAC,KAAa,oBAAuE;AACjF,YAAM,SAAS,GAAG,SAAS;AAC3B,YAAM,WAAW,IAAI,WAAW,MAAM,IAAI,IAAI,MAAM,OAAO,MAAM,IAAI;AACrE,aAAO,KAAK,EAAE,UAAU,eAAe;AAAA,IAC3C;AAAA,IACA,CAAC,IAAI;AAAA,EACT;AACA,QAAM,UAAU,KAAK,WAAW;AAEhC,SAAO,MAAM;AAAA,IACT,OAAO;AAAA,MACH;AAAA,MACA;AAAA,MACA,QAAQ,KAAK;AAAA,MACb,UAAU,KAAK;AAAA,MACf,WAAW,KAAK;AAAA,MAChB,kBAAkB,KAAK;AAAA,MACvB,WAAW,KAAK;AAAA,MAChB;AAAA,IACJ;AAAA,IACA;AAAA,MACI;AAAA,MACA;AAAA,MACA,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL;AAAA,IACJ;AAAA,EACJ;AACJ;AAqBA,IAAM,wBAA6C;AAAA,EAC/C,UAAU;AAAA,EACV,YAAY,CAAC;AAAA,EACb,cAAc;AAAA,EACd,WAAW;AAAA,EACX,SAAS;AAAA,EACT,gBAAgB,MAAM;AAAA,EACtB,aAAa,CAAC,OAAO,iBAAiB,GAAG,gBAAgB,iBAAiB,IAAI,KAAK,QAAQ,KAAK,QAAQ,CAAC,CAAC;AAC9G;AAEO,IAAM,wBAAwB,MAAM,cAAmC,qBAAqB;AAE5F,SAAS,oBAAyC;AACrD,SAAO,MAAM,WAAW,qBAAqB;AACjD;AAsBA,IAAI,kBAA+D;AASnE,IAAI,sBAAiD;AACrD,IAAM,2BAA2B,MAAM,MAAM;AAOtC,SAAS,gBAAgB,WAAiD;AAC7E,oBAAkB;AACtB;AAOO,SAAS,wBAAwB,UAAqC;AACzE,wBAAsB;AAC1B;AAMO,SAAS,cAAc,MAAuB;AACjD,QAAM,cAAc,MAAM,qBAAqB,IAAI,IAAI,KAAK;AAE5D,SAAO,MAAM;AAAA,IACT,qBAAqB,aAAa;AAAA,IAClC;AAAA,IACA;AAAA,EACJ;AACJ;AAuBO,SAAS,WAAW,OAAmD;AAC1E,MAAI,CAAC,iBAAiB;AAElB,WAAO;AAAA,EACX;AACA,SAAO,MAAM,cAAc,iBAAiB,KAAK;AACrD;AAqBO,IAAM,oCAAoC;AAmB1C,SAAS,cAAc;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA,SAAS;AAAA,EACT;AACJ,GAAkD;AAC9C,QAAM,WAAW,MAAM,OAAuB,IAAI;AAClD,QAAM,YAAY,MAAM,OAAmC,EAAE,MAAM,YAAY,OAAO,OAAO,CAAC;AAC9F,YAAU,UAAU,EAAE,MAAM,YAAY,OAAO,OAAO;AAEtD,QAAM,gBAAgB,MAAM,YAAY,MAAM;AAC1C,UAAM,QAAQ,SAAS;AACvB,UAAM,UAAU,OAAO,WAAW,cAAc,SAAY,OAAO;AACnE,QAAI,CAAC,SAAS,CAAC,QAAS;AACxB,YAAQ,WAAW,OAAO,UAAU,OAAO;AAAA,EAC/C,GAAG,CAAC,CAAC;AAEL,QAAM,UAAU,MAAM;AAClB,QAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,UAAM,QAAQ,SAAS;AACvB,WAAO,iBAAiB,mCAAmC,aAAa;AACxE,WAAO,MAAM;AACT,aAAO,oBAAoB,mCAAmC,aAAa;AAC3E,UAAI,MAAO,QAAO,8BAA8B,YAAY,KAAK;AAAA,IACrE;AAAA,EACJ,GAAG,CAAC,aAAa,CAAC;AAElB,QAAM,UAAU,MAAM;AAClB,kBAAc;AAAA,EAClB,CAAC;AAED,MAAI,WAAW,WAAW,EAAG,QAAO;AAEpC,SAAO,MAAM,cAAc,OAAO;AAAA,IAC9B,KAAK;AAAA,IACL;AAAA,IACA,6BAA6B;AAAA,EACjC,CAAC;AACL;AAcA,IAAM,iBAAgC,EAAE,KAAK,MAAM,KAAK;AAMjD,IAAM,uBAAuB,MAAM,cAA6B,cAAc;AAgB9E,SAAS,mBAAkC;AAC9C,SAAO,MAAM,WAAW,oBAAoB;AAChD;AA0BO,SAAS,iBAAiB;AAC7B,SAAO;AAAA,IACH,YAAY,CAAC,YAAgC;AAGzC,UAAI,OAAO,WAAW,aAAa;AAG/B,cAAM,SAAS,OAAO,8BAA8B,OAAO;AAC3D,YAAI,QAAQ;AACR,iBAAO,KAAK,OAAO;AACnB;AAAA,QACJ;AAAA,MACJ;AACA,cAAQ,KAAK,+DAA+D;AAAA,IAChF;AAAA,EACJ;AACJ;","names":[]}