@iris-ui-kit/react 0.1.0

package/dist/provider.cjs

@@ -0,0 +1,191 @@
+'use client'
+'use strict';
+
+var React3 = require('react');
+var core = require('@iris-ui-kit/core');
+var theme = require('@iris-ui-kit/theme');
+var jsxRuntime = require('react/jsx-runtime');
+var skins = require('@iris-ui-kit/skins');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React3__namespace = /*#__PURE__*/_interopNamespace(React3);
+
+// src/provider/IrisProvider.tsx
+function useStore(store) {
+  return React3.useSyncExternalStore(
+    store.subscribe,
+    store.getState,
+    store.getState
+    // SSR fallback — same as client snapshot in our case.
+  );
+}
+var IrisThemeContext = React3.createContext(null);
+function ThemeProvider({
+  store,
+  target = null,
+  dir = "ltr",
+  cspNonce,
+  children
+}) {
+  const current = useStore(store.store);
+  const appliedRef = React3.useRef(null);
+  React3.useEffect(() => {
+    theme.injectGlobalStyles(cspNonce);
+    const el = target ?? document.documentElement;
+    appliedRef.current?.revert();
+    appliedRef.current = theme.applyTheme(current, el);
+    const dirApplied = theme.applyDirection(dir, el);
+    return () => {
+      appliedRef.current?.revert();
+      appliedRef.current = null;
+      dirApplied.revert();
+    };
+  }, [current, target, dir]);
+  return /* @__PURE__ */ jsxRuntime.jsx(IrisThemeContext.Provider, { value: { store, current, dir }, children });
+}
+var IrisSkinContext = React3.createContext(null);
+function SkinProvider({ engine, target = null, cspNonce, children }) {
+  const current = useStore(engine.store);
+  const appliedRef = React3.useRef(null);
+  React3.useEffect(() => {
+    theme.injectGlobalStyles(cspNonce);
+    const el = target ?? document.documentElement;
+    appliedRef.current?.revert();
+    appliedRef.current = skins.applySkin(current, el);
+    return () => {
+      appliedRef.current?.revert();
+      appliedRef.current = null;
+    };
+  }, [current, target]);
+  return /* @__PURE__ */ jsxRuntime.jsx(IrisSkinContext.Provider, { value: { engine, current }, children });
+}
+var I18nContext = React3__namespace.createContext(null);
+function IrisI18nProvider({
+  locale,
+  messages,
+  i18n,
+  autoDirection,
+  directionTarget,
+  children
+}) {
+  const ref = React3__namespace.useRef(null);
+  if (ref.current === null) {
+    ref.current = i18n ?? core.createI18n({ locale, messages });
+  }
+  const instance = ref.current;
+  React3__namespace.useEffect(() => {
+    if (i18n || !locale) return;
+    instance.setLocale(locale);
+  }, [locale, i18n, instance]);
+  React3__namespace.useEffect(() => {
+    if (i18n || !messages) return;
+    instance.setMessages(messages);
+  }, [messages, i18n, instance]);
+  React3__namespace.useEffect(() => {
+    if (!autoDirection || !locale || typeof document === "undefined") return;
+    const el = directionTarget ?? document.documentElement;
+    const applied = theme.applyDirection(core.localeDirection(locale), el);
+    const prevLang = el.getAttribute("lang");
+    el.setAttribute("lang", locale);
+    return () => {
+      applied.revert();
+      if (prevLang === null) el.removeAttribute("lang");
+      else el.setAttribute("lang", prevLang);
+    };
+  }, [autoDirection, locale, directionTarget]);
+  return /* @__PURE__ */ jsxRuntime.jsx(I18nContext.Provider, { value: instance, children });
+}
+var PluginStoreContext = React3.createContext(null);
+function IrisProvider({
+  theme: theme$1,
+  skin,
+  dir = "ltr",
+  locale,
+  messages,
+  plugins,
+  target = null,
+  children
+}) {
+  const collected = React3.useMemo(() => core.runPlugins(plugins ?? []), [plugins]);
+  const appliedRef = React3.useRef(null);
+  React3.useEffect(() => {
+    if (typeof document === "undefined") return;
+    const el = target ?? document.documentElement;
+    appliedRef.current?.revert();
+    appliedRef.current = theme.applyCssVars(Object.entries(collected.tokens), el);
+    return () => {
+      appliedRef.current?.revert();
+      appliedRef.current = null;
+    };
+  }, [collected, target]);
+  React3.useEffect(() => () => collected.teardown(), [collected]);
+  const value = React3.useMemo(
+    () => ({ stores: collected.stores, installed: new Set((plugins ?? []).map((p) => p.name)) }),
+    [collected, plugins]
+  );
+  const merged = { ...collected.messages[locale ?? "en-US"], ...messages ?? {} };
+  let tree = /* @__PURE__ */ jsxRuntime.jsx(IrisI18nProvider, { locale, messages: merged, children: /* @__PURE__ */ jsxRuntime.jsx(PluginStoreContext.Provider, { value, children }) });
+  if (skin) {
+    tree = /* @__PURE__ */ jsxRuntime.jsx(SkinProvider, { engine: skin, target, children: tree });
+  }
+  if (theme$1) {
+    tree = /* @__PURE__ */ jsxRuntime.jsx(ThemeProvider, { store: theme$1, dir, target, children: tree });
+  }
+  return tree;
+}
+function usePlugin(name) {
+  return React3.useContext(PluginStoreContext)?.installed.has(name) ?? false;
+}
+var warnedKeys = /* @__PURE__ */ new Map();
+function usePluginStore(nsOrKey, key) {
+  const ctx = React3.useContext(PluginStoreContext);
+  if (!ctx) {
+    const displayKey = key !== void 0 ? `${nsOrKey}::${key}` : nsOrKey;
+    throw new Error(`[iris-ui] usePluginStore("${displayKey}"): no <IrisProvider> ancestor found`);
+  }
+  const fullKey = key !== void 0 ? `${nsOrKey}::${key}` : nsOrKey;
+  let store = ctx.stores.get(fullKey);
+  if (store !== void 0) return store;
+  if (key === void 0) {
+    store = ctx.stores.get(nsOrKey);
+    if (store !== void 0) return store;
+    for (const k of ctx.stores.keys()) {
+      if (typeof k === "string" && k.endsWith(`::${nsOrKey}`)) {
+        if (!warnedKeys.has(nsOrKey)) {
+          warnedKeys.set(nsOrKey, true);
+          console.warn(
+            `[iris-ui] Ambiguous plugin store key "${nsOrKey}". Found "${k}". Use the namespaced form for clarity: usePluginStore("${k}").`
+          );
+        }
+        return ctx.stores.get(k);
+      }
+    }
+  }
+  throw new Error(
+    `[iris-ui] Plugin store "${fullKey}" not found. Ensure the plugin is installed in IrisProvider and the key is correct.`
+  );
+}
+
+exports.IrisProvider = IrisProvider;
+exports.PluginStoreContext = PluginStoreContext;
+exports.usePlugin = usePlugin;
+exports.usePluginStore = usePluginStore;
+//# sourceMappingURL=provider.cjs.map
+//# sourceMappingURL=provider.cjs.map

package/dist/provider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useStore.ts","../src/theme/ThemeProvider.tsx","../src/skins/SkinProvider.tsx","../src/i18n/context.ts","../src/i18n/I18nProvider.tsx","../src/provider/context.ts","../src/provider/IrisProvider.tsx"],"names":["useSyncExternalStore","createContext","useRef","useEffect","injectGlobalStyles","applyTheme","applyDirection","jsx","applySkin","React2","React3","createI18n","localeDirection","theme","useMemo","runPlugins","applyCssVars","useContext"],"mappings":"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","file":"provider.cjs","sourcesContent":["import * as React from 'react'\nimport { useSyncExternalStore } from 'react'\nimport type { ReadonlyStore, Store } from '@iris-ui-kit/core'\n\n/**\n * Bridge a framework-agnostic `@iris-ui-kit/core` store into React reactivity.\n * Uses React 18's `useSyncExternalStore` — the contract is identical to the\n * one Vue uses via `ref + onMounted` and Solid uses via `createSignal`. The\n * **same** store can power Button, Popover, Dialog, etc. on any framework.\n */\nexport function useStore<T>(store: ReadonlyStore<T>): T {\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getState,\n    store.getState, // SSR fallback — same as client snapshot in our case.\n  )\n}\n\n/**\n * Subscribe to a DERIVED slice of a core store — the component re-renders only\n * when `selector(state)` changes per `isEqual` (default `Object.is`), not on\n * every store emission. Built on {@link Store.subscribeWith}. Inline closures\n * for `selector`/`isEqual` are fine (captured via refs; the subscription is not\n * re-created between renders).\n */\nexport function useStoreSelector<T, U>(\n  store: Store<T>,\n  selector: (state: T) => U,\n  isEqual?: (a: U, b: U) => boolean,\n): U {\n  const [slice, setSlice] = React.useState(() => selector(store.getState()))\n  const selRef = React.useRef(selector)\n  selRef.current = selector\n  const eqRef = React.useRef(isEqual)\n  eqRef.current = isEqual\n  React.useEffect(() => {\n    const read = (s: T): U => selRef.current(s)\n    const eq = (a: U, b: U): boolean => (eqRef.current ?? Object.is)(a, b)\n    // Re-sync in case the store moved between render and this effect.\n    setSlice((prev) => {\n      const next = read(store.getState())\n      return eq(prev, next) ? prev : next\n    })\n    return store.subscribeWith(read, setSlice, eq)\n  }, [store])\n  return slice\n}\n","import { createContext, useContext, useEffect, useRef, type ReactNode } from 'react'\nimport {\n  applyDirection,\n  applyTheme,\n  injectGlobalStyles,\n  type ApplyThemeResult,\n  type Direction,\n  type ThemeStore,\n} from '@iris-ui-kit/theme'\nimport type { IrisTheme } from '@iris-ui-kit/tokens'\nimport { useStore } from '../useStore'\n\ninterface IrisThemeContextValue {\n  store: ThemeStore\n  current: IrisTheme\n  dir: Direction\n}\n\nconst IrisThemeContext = createContext<IrisThemeContextValue | null>(null)\n\nexport interface ThemeProviderProps {\n  store: ThemeStore\n  target?: HTMLElement | null\n  /** Writing direction; sets `dir` on the target for RTL. Default `'ltr'`. */\n  dir?: Direction\n  /** CSP nonce for the injected global stylesheet. Pass the `nonce` from your\n   *  server-rendered CSP header when you use `style-src: 'nonce-...'`. */\n  cspNonce?: string\n  children?: ReactNode\n}\n\n/**\n * Renderless provider that mirrors `<IrisThemeProvider>` from `@iris-ui-kit/vue`:\n * subscribes to the theme store, applies CSS variables to `target` (or\n * `document.documentElement`), reverts on unmount.\n *\n * **Zero business logic** — `applyTheme` / `createThemeStore` come straight\n * from `@iris-ui-kit/theme`. This component is just a 30-line React adapter.\n */\nexport function ThemeProvider({\n  store,\n  target = null,\n  dir = 'ltr',\n  cspNonce,\n  children,\n}: ThemeProviderProps) {\n  const current = useStore(store.store)\n  const appliedRef = useRef<ApplyThemeResult | null>(null)\n\n  useEffect(() => {\n    injectGlobalStyles(cspNonce)\n    const el = target ?? document.documentElement\n    appliedRef.current?.revert()\n    appliedRef.current = applyTheme(current, el)\n    const dirApplied = applyDirection(dir, el)\n    return () => {\n      appliedRef.current?.revert()\n      appliedRef.current = null\n      dirApplied.revert()\n    }\n  }, [current, target, dir])\n\n  return (\n    <IrisThemeContext.Provider value={{ store, current, dir }}>\n      {children}\n    </IrisThemeContext.Provider>\n  )\n}\n\nexport function useThemeContext(): IrisThemeContextValue {\n  const ctx = useContext(IrisThemeContext)\n  if (!ctx) {\n    throw new Error('[iris-ui] useTheme(): no <ThemeProvider> ancestor found')\n  }\n  return ctx\n}\n\n/**\n * Read the current theme without throwing when there is no `<ThemeProvider>`\n * ancestor. Returns `undefined` outside a provider. Used by theme-aware\n * primitives (e.g. `IrisIcon`) that must still render standalone.\n */\nexport function useThemeOptional(): IrisTheme | undefined {\n  return useContext(IrisThemeContext)?.current\n}\n\n/**\n * Current writing direction (`'ltr'` / `'rtl'`) from the nearest\n * `<ThemeProvider>`, or `'ltr'` when there is none. For components that need to\n * branch on direction beyond what CSS logical properties already handle.\n */\nexport function useDirection(): Direction {\n  return useContext(IrisThemeContext)?.dir ?? 'ltr'\n}\n","import { createContext, useContext, useEffect, useRef, type ReactNode } from 'react'\nimport { injectGlobalStyles } from '@iris-ui-kit/theme'\nimport {\n  applySkin,\n  type ApplySkinResult,\n  type ResolvedSkin,\n  type SkinEngine,\n} from '@iris-ui-kit/skins'\nimport { useStore } from '../useStore'\n\ninterface IrisSkinContextValue {\n  engine: SkinEngine\n  current: ResolvedSkin\n}\n\nconst IrisSkinContext = createContext<IrisSkinContextValue | null>(null)\n\nexport interface SkinProviderProps {\n  engine: SkinEngine\n  target?: HTMLElement | null\n  /** CSP nonce for the injected global stylesheet. */\n  cspNonce?: string\n  children?: ReactNode\n}\n\n/**\n * Renderless provider mirroring `<ThemeProvider>`: subscribes to the skin\n * engine's store, applies the resolved skin's CSS vars to `target` (or\n * `document.documentElement`), reverts on unmount. Zero skin logic — all of it\n * lives in `@iris-ui-kit/skins`. Client boundary (tsup prepends `'use client'`).\n */\nexport function SkinProvider({ engine, target = null, cspNonce, children }: SkinProviderProps) {\n  const current = useStore(engine.store)\n  const appliedRef = useRef<ApplySkinResult | null>(null)\n\n  useEffect(() => {\n    injectGlobalStyles(cspNonce)\n    const el = target ?? document.documentElement\n    appliedRef.current?.revert()\n    appliedRef.current = applySkin(current, el)\n    return () => {\n      appliedRef.current?.revert()\n      appliedRef.current = null\n    }\n  }, [current, target])\n\n  return <IrisSkinContext.Provider value={{ engine, current }}>{children}</IrisSkinContext.Provider>\n}\n\nexport function useSkinContext(): IrisSkinContextValue {\n  const ctx = useContext(IrisSkinContext)\n  if (!ctx) throw new Error('[iris-ui] useSkin(): no <SkinProvider> ancestor found')\n  return ctx\n}\n\n/** Non-throwing read for skin-aware primitives that may render standalone. */\nexport function useSkinOptional(): ResolvedSkin | undefined {\n  return useContext(IrisSkinContext)?.current\n}\n","import * as React from 'react'\nimport type { I18n } from '@iris-ui-kit/core'\n\n/** Carries the active {@link I18n} instance to descendants via `useI18n`. */\nexport const I18nContext = React.createContext<I18n | null>(null)\n","import * as React from 'react'\nimport { createI18n, localeDirection, type I18n, type I18nMessages } from '@iris-ui-kit/core'\nimport { applyDirection } from '@iris-ui-kit/theme'\nimport { I18nContext } from './context'\n\nexport interface IrisI18nProviderProps {\n  /** BCP-47 locale. Changes are synced to the live instance. */\n  locale?: string\n  /** Message overrides. Changes are merged into the live instance. */\n  messages?: I18nMessages\n  /** Provide a pre-created instance instead of `locale` / `messages`. */\n  i18n?: I18n\n  /**\n   * When set, the locale's writing direction ({@link localeDirection}) is\n   * applied to `directionTarget` (`dir` + `data-iris-dir`) and `<html lang>` is\n   * set whenever `locale` changes — so \"set locale → flip direction + announce\n   * language\" needs no manual wiring. Off by default so it never fights an\n   * explicit `<ThemeProvider dir>`. Reverts on unmount.\n   */\n  autoDirection?: boolean\n  /** Element to receive dir/lang when `autoDirection` is set. Defaults to `document.documentElement`. */\n  directionTarget?: HTMLElement | null\n  children?: React.ReactNode\n}\n\n/**\n * Makes a locale + message dictionary available to descendant components via\n * `useI18n`. Either pass `locale` / `messages` (an instance is created and\n * kept in sync) or a pre-built `i18n` instance you control externally.\n */\nexport function IrisI18nProvider({\n  locale,\n  messages,\n  i18n,\n  autoDirection,\n  directionTarget,\n  children,\n}: IrisI18nProviderProps) {\n  const ref = React.useRef<I18n | null>(null)\n  if (ref.current === null) {\n    ref.current = i18n ?? createI18n({ locale, messages })\n  }\n  const instance = ref.current\n\n  React.useEffect(() => {\n    if (i18n || !locale) return\n    instance.setLocale(locale)\n  }, [locale, i18n, instance])\n\n  React.useEffect(() => {\n    if (i18n || !messages) return\n    instance.setMessages(messages)\n  }, [messages, i18n, instance])\n\n  // Auto-apply writing direction + `lang` from the active locale (opt-in).\n  React.useEffect(() => {\n    if (!autoDirection || !locale || typeof document === 'undefined') return\n    const el = directionTarget ?? document.documentElement\n    const applied = applyDirection(localeDirection(locale), el)\n    const prevLang = el.getAttribute('lang')\n    el.setAttribute('lang', locale)\n    return () => {\n      applied.revert()\n      if (prevLang === null) el.removeAttribute('lang')\n      else el.setAttribute('lang', prevLang)\n    }\n  }, [autoDirection, locale, directionTarget])\n\n  return <I18nContext.Provider value={instance}>{children}</I18nContext.Provider>\n}\n","import { createContext } from 'react'\n\n/**\n * What `<IrisProvider>` hands to descendants: the eagerly-built plugin stores\n * (keyed by registration name) plus the set of installed plugin names.\n *\n * Named `*Context` so the manifest's discover step EXCLUDES it — only\n * `Iris*`-prefixed, non-`Context` exports become manifest components.\n */\nexport interface PluginStoreContextValue {\n  stores: Map<string, unknown>\n  installed: Set<string>\n}\n\nexport const PluginStoreContext = createContext<PluginStoreContextValue | null>(null)\n","import { useContext, useEffect, useMemo, useRef, type ReactNode } from 'react'\nimport { runPlugins, type IrisPlugin } from '@iris-ui-kit/core'\nimport {\n  applyCssVars,\n  type ApplyCssVarsResult,\n  type Direction,\n  type ThemeStore,\n} from '@iris-ui-kit/theme'\nimport type { SkinEngine } from '@iris-ui-kit/skins'\nimport { ThemeProvider } from '../theme'\nimport { SkinProvider } from '../skins'\nimport { IrisI18nProvider } from '../i18n'\nimport { PluginStoreContext } from './context'\n\nexport interface IrisProviderProps {\n  /** Active theme store. When passed, wraps children in `<ThemeProvider>`. */\n  theme?: ThemeStore\n  /** Active skin engine. When passed, wraps children in `<SkinProvider>`. */\n  skin?: SkinEngine\n  /** Writing direction; forwarded to `<ThemeProvider>`. Default `'ltr'`. */\n  dir?: Direction\n  /** BCP-47 locale; selects which plugin message slice is applied. */\n  locale?: string\n  /** User message overrides — these WIN over plugin-registered messages. */\n  messages?: Record<string, string>\n  /** Plugins to install. Their tokens / messages / stores are collected once. */\n  plugins?: IrisPlugin[]\n  /** Element to receive plugin tokens. Defaults to `document.documentElement`. */\n  target?: HTMLElement | null\n  children?: ReactNode\n}\n\n/**\n * The single unified entry point. Runs the plugins, applies their additive\n * token layer over the active theme, merges their messages under the user's,\n * and exposes their stores via `PluginStoreContext`. The existing\n * Theme / Skin / I18n providers are composed in around it.\n *\n * **Zero business logic** — `runPlugins` / `applyCssVars` do the work; this is a\n * thin React bridge. Client boundary (tsup prepends `'use client'`).\n */\nexport function IrisProvider({\n  theme,\n  skin,\n  dir = 'ltr',\n  locale,\n  messages,\n  plugins,\n  target = null,\n  children,\n}: IrisProviderProps) {\n  const collected = useMemo(() => runPlugins(plugins ?? []), [plugins])\n  const appliedRef = useRef<ApplyCssVarsResult | null>(null)\n\n  useEffect(() => {\n    if (typeof document === 'undefined') return\n    const el = target ?? document.documentElement\n    appliedRef.current?.revert()\n    appliedRef.current = applyCssVars(Object.entries(collected.tokens), el)\n    return () => {\n      appliedRef.current?.revert()\n      appliedRef.current = null\n    }\n  }, [collected, target])\n\n  // Run plugin teardowns when the plugins set is swapped (a new `collected`) or\n  // on unmount, so eager stores / subscriptions / timers don't leak.\n  useEffect(() => () => collected.teardown(), [collected])\n\n  const value = useMemo(\n    () => ({ stores: collected.stores, installed: new Set((plugins ?? []).map((p) => p.name)) }),\n    [collected, plugins],\n  )\n\n  // Plugin messages are the BASE; user-supplied messages win.\n  const merged = { ...collected.messages[locale ?? 'en-US'], ...(messages ?? {}) }\n\n  // Order (innermost-out): Theme → Skin → I18n → PluginContext → children.\n  let tree: ReactNode = (\n    <IrisI18nProvider locale={locale} messages={merged}>\n      <PluginStoreContext.Provider value={value}>{children}</PluginStoreContext.Provider>\n    </IrisI18nProvider>\n  )\n  if (skin) {\n    tree = (\n      <SkinProvider engine={skin} target={target}>\n        {tree}\n      </SkinProvider>\n    )\n  }\n  if (theme) {\n    tree = (\n      <ThemeProvider store={theme} dir={dir} target={target}>\n        {tree}\n      </ThemeProvider>\n    )\n  }\n  return tree\n}\n\n/** Whether a plugin with `name` is installed under the nearest `<IrisProvider>`. */\nexport function usePlugin(name: string): boolean {\n  return useContext(PluginStoreContext)?.installed.has(name) ?? false\n}\n\n// Tracks ambiguous store key warnings to avoid spamming the console.\n// Hoisted BEFORE overload signatures (TS requires overloads immediately before implementation).\nconst warnedKeys = new Map<string, boolean>()\n\n/**\n * Read a plugin-registered store by `key` (backward-compatible single-arg form).\n * Falls back to `{namespace}::{key}` lookup if bare key not found.\n * Throws a clear error when there is no `<IrisProvider>` ancestor.\n * Plugins export typed wrappers narrowing `T`.\n */\nexport function usePluginStore<T>(key: string): T\n\n/**\n * Read a plugin-registered store by `namespace` + `key`.\n * Equivalent to `usePluginStore('{namespace}::{key}')`.\n */\nexport function usePluginStore<T>(namespace: string, key: string): T\n\nexport function usePluginStore<T>(nsOrKey: string, key?: string): T {\n  const ctx = useContext(PluginStoreContext)\n  if (!ctx) {\n    const displayKey = key !== undefined ? `${nsOrKey}::${key}` : nsOrKey\n    throw new Error(`[iris-ui] usePluginStore(\"${displayKey}\"): no <IrisProvider> ancestor found`)\n  }\n\n  const fullKey = key !== undefined ? `${nsOrKey}::${key}` : nsOrKey\n\n  // 1. Direct lookup using the constructed key\n  let store = ctx.stores.get(fullKey) as T | undefined\n  if (store !== undefined) return store\n\n  // 2. Single-arg: try without namespace first (backward compat for unnamespaced plugins)\n  if (key === undefined) {\n    // Try the key as a bare key (for plugins without namespace)\n    store = ctx.stores.get(nsOrKey) as T | undefined\n    if (store !== undefined) return store\n\n    // Try as {namespace}::{key} where namespace may equal the key segment\n    // e.g. usePluginStore('settings') → try 'default::settings', 'editor::settings', etc.\n    // This handles plugins where namespace === name (the common case).\n    for (const k of ctx.stores.keys()) {\n      if (typeof k === 'string' && k.endsWith(`::${nsOrKey}`)) {\n        // Warn at most once per ambiguous key.\n        if (!warnedKeys.has(nsOrKey)) {\n          warnedKeys.set(nsOrKey, true)\n          console.warn(\n            `[iris-ui] Ambiguous plugin store key \"${nsOrKey}\". ` +\n              `Found \"${k}\". Use the namespaced form for clarity: ` +\n              `usePluginStore(\"${k}\").`,\n          )\n        }\n        return ctx.stores.get(k) as T\n      }\n    }\n  }\n\n  throw new Error(\n    `[iris-ui] Plugin store \"${fullKey}\" not found. ` +\n      `Ensure the plugin is installed in IrisProvider and the key is correct.`,\n  )\n}\n"]}

package/dist/provider.d.cts

@@ -0,0 +1,62 @@
+import * as React from 'react';
+import { ReactNode } from 'react';
+import { IrisPlugin } from '@iris-ui-kit/core';
+import { ThemeStore, Direction } from '@iris-ui-kit/theme';
+import { SkinEngine } from '@iris-ui-kit/skins';
+
+interface IrisProviderProps {
+    /** Active theme store. When passed, wraps children in `<ThemeProvider>`. */
+    theme?: ThemeStore;
+    /** Active skin engine. When passed, wraps children in `<SkinProvider>`. */
+    skin?: SkinEngine;
+    /** Writing direction; forwarded to `<ThemeProvider>`. Default `'ltr'`. */
+    dir?: Direction;
+    /** BCP-47 locale; selects which plugin message slice is applied. */
+    locale?: string;
+    /** User message overrides — these WIN over plugin-registered messages. */
+    messages?: Record<string, string>;
+    /** Plugins to install. Their tokens / messages / stores are collected once. */
+    plugins?: IrisPlugin[];
+    /** Element to receive plugin tokens. Defaults to `document.documentElement`. */
+    target?: HTMLElement | null;
+    children?: ReactNode;
+}
+/**
+ * The single unified entry point. Runs the plugins, applies their additive
+ * token layer over the active theme, merges their messages under the user's,
+ * and exposes their stores via `PluginStoreContext`. The existing
+ * Theme / Skin / I18n providers are composed in around it.
+ *
+ * **Zero business logic** — `runPlugins` / `applyCssVars` do the work; this is a
+ * thin React bridge. Client boundary (tsup prepends `'use client'`).
+ */
+declare function IrisProvider({ theme, skin, dir, locale, messages, plugins, target, children, }: IrisProviderProps): React.ReactElement<any, string | React.JSXElementConstructor<any>>;
+/** Whether a plugin with `name` is installed under the nearest `<IrisProvider>`. */
+declare function usePlugin(name: string): boolean;
+/**
+ * Read a plugin-registered store by `key` (backward-compatible single-arg form).
+ * Falls back to `{namespace}::{key}` lookup if bare key not found.
+ * Throws a clear error when there is no `<IrisProvider>` ancestor.
+ * Plugins export typed wrappers narrowing `T`.
+ */
+declare function usePluginStore<T>(key: string): T;
+/**
+ * Read a plugin-registered store by `namespace` + `key`.
+ * Equivalent to `usePluginStore('{namespace}::{key}')`.
+ */
+declare function usePluginStore<T>(namespace: string, key: string): T;
+
+/**
+ * What `<IrisProvider>` hands to descendants: the eagerly-built plugin stores
+ * (keyed by registration name) plus the set of installed plugin names.
+ *
+ * Named `*Context` so the manifest's discover step EXCLUDES it — only
+ * `Iris*`-prefixed, non-`Context` exports become manifest components.
+ */
+interface PluginStoreContextValue {
+    stores: Map<string, unknown>;
+    installed: Set<string>;
+}
+declare const PluginStoreContext: React.Context<PluginStoreContextValue | null>;
+
+export { IrisProvider, type IrisProviderProps, PluginStoreContext, type PluginStoreContextValue, usePlugin, usePluginStore };

package/dist/provider.d.ts

@@ -0,0 +1,62 @@
+import * as React from 'react';
+import { ReactNode } from 'react';
+import { IrisPlugin } from '@iris-ui-kit/core';
+import { ThemeStore, Direction } from '@iris-ui-kit/theme';
+import { SkinEngine } from '@iris-ui-kit/skins';
+
+interface IrisProviderProps {
+    /** Active theme store. When passed, wraps children in `<ThemeProvider>`. */
+    theme?: ThemeStore;
+    /** Active skin engine. When passed, wraps children in `<SkinProvider>`. */
+    skin?: SkinEngine;
+    /** Writing direction; forwarded to `<ThemeProvider>`. Default `'ltr'`. */
+    dir?: Direction;
+    /** BCP-47 locale; selects which plugin message slice is applied. */
+    locale?: string;
+    /** User message overrides — these WIN over plugin-registered messages. */
+    messages?: Record<string, string>;
+    /** Plugins to install. Their tokens / messages / stores are collected once. */
+    plugins?: IrisPlugin[];
+    /** Element to receive plugin tokens. Defaults to `document.documentElement`. */
+    target?: HTMLElement | null;
+    children?: ReactNode;
+}
+/**
+ * The single unified entry point. Runs the plugins, applies their additive
+ * token layer over the active theme, merges their messages under the user's,
+ * and exposes their stores via `PluginStoreContext`. The existing
+ * Theme / Skin / I18n providers are composed in around it.
+ *
+ * **Zero business logic** — `runPlugins` / `applyCssVars` do the work; this is a
+ * thin React bridge. Client boundary (tsup prepends `'use client'`).
+ */
+declare function IrisProvider({ theme, skin, dir, locale, messages, plugins, target, children, }: IrisProviderProps): React.ReactElement<any, string | React.JSXElementConstructor<any>>;
+/** Whether a plugin with `name` is installed under the nearest `<IrisProvider>`. */
+declare function usePlugin(name: string): boolean;
+/**
+ * Read a plugin-registered store by `key` (backward-compatible single-arg form).
+ * Falls back to `{namespace}::{key}` lookup if bare key not found.
+ * Throws a clear error when there is no `<IrisProvider>` ancestor.
+ * Plugins export typed wrappers narrowing `T`.
+ */
+declare function usePluginStore<T>(key: string): T;
+/**
+ * Read a plugin-registered store by `namespace` + `key`.
+ * Equivalent to `usePluginStore('{namespace}::{key}')`.
+ */
+declare function usePluginStore<T>(namespace: string, key: string): T;
+
+/**
+ * What `<IrisProvider>` hands to descendants: the eagerly-built plugin stores
+ * (keyed by registration name) plus the set of installed plugin names.
+ *
+ * Named `*Context` so the manifest's discover step EXCLUDES it — only
+ * `Iris*`-prefixed, non-`Context` exports become manifest components.
+ */
+interface PluginStoreContextValue {
+    stores: Map<string, unknown>;
+    installed: Set<string>;
+}
+declare const PluginStoreContext: React.Context<PluginStoreContextValue | null>;
+
+export { IrisProvider, type IrisProviderProps, PluginStoreContext, type PluginStoreContextValue, usePlugin, usePluginStore };

package/dist/provider.js

@@ -0,0 +1,8 @@
+'use client'
+export { IrisProvider, PluginStoreContext, usePlugin, usePluginStore } from './chunk-IDD35UJ6.js';
+import './chunk-WIHBIDVJ.js';
+import './chunk-XCK4RIXB.js';
+import './chunk-OMOTUHYI.js';
+import './chunk-RZNYIFV2.js';
+//# sourceMappingURL=provider.js.map
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":";","file":"provider.js"}

package/dist/resource.cjs

@@ -0,0 +1,61 @@
+'use client'
+'use strict';
+
+var React2 = require('react');
+var core = require('@iris-ui-kit/core');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React2__namespace = /*#__PURE__*/_interopNamespace(React2);
+
+// src/resource/useResourceController.ts
+function useStore(store) {
+  return React2.useSyncExternalStore(
+    store.subscribe,
+    store.getState,
+    store.getState
+    // SSR fallback — same as client snapshot in our case.
+  );
+}
+
+// src/resource/useResourceController.ts
+function useResourceController(config) {
+  const ref = React2__namespace.useRef(null);
+  if (ref.current === null) ref.current = core.createResourceController({ ...config, immediate: false });
+  const controller = ref.current;
+  const immediate = config.immediate !== false;
+  React2__namespace.useEffect(() => {
+    if (immediate) void controller.load();
+    return () => controller.destroy();
+  }, [controller, immediate]);
+  const state = useStore(controller.store);
+  return React2__namespace.useMemo(() => ({ ...controller, state }), [controller, state]);
+}
+
+Object.defineProperty(exports, "createClientFetcher", {
+  enumerable: true,
+  get: function () { return core.createClientFetcher; }
+});
+Object.defineProperty(exports, "createResourceController", {
+  enumerable: true,
+  get: function () { return core.createResourceController; }
+});
+exports.useResourceController = useResourceController;
+//# sourceMappingURL=resource.cjs.map
+//# sourceMappingURL=resource.cjs.map

package/dist/resource.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useStore.ts","../src/resource/useResourceController.ts"],"names":["useSyncExternalStore","React2","createResourceController"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAUO,SAAS,SAAY,KAAA,EAA4B;AACtD,EAAA,OAAOA,2BAAA;AAAA,IACL,KAAA,CAAM,SAAA;AAAA,IACN,KAAA,CAAM,QAAA;AAAA,IACN,KAAA,CAAM;AAAA;AAAA,GACR;AACF;;;ACSO,SAAS,sBACd,MAAA,EAC0B;AAC1B,EAAA,MAAM,GAAA,GAAYC,yBAAqC,IAAI,CAAA;AAC3D,EAAA,IAAI,GAAA,CAAI,OAAA,KAAY,IAAA,EAAM,GAAA,CAAI,OAAA,GAAUC,6BAAA,CAAyB,EAAE,GAAG,MAAA,EAAQ,SAAA,EAAW,KAAA,EAAO,CAAA;AAChG,EAAA,MAAM,aAAa,GAAA,CAAI,OAAA;AACvB,EAAA,MAAM,SAAA,GAAY,OAAO,SAAA,KAAc,KAAA;AAIvC,EAAMD,4BAAU,MAAM;AACpB,IAAA,IAAI,SAAA,EAAW,KAAK,UAAA,CAAW,IAAA,EAAK;AACpC,IAAA,OAAO,MAAM,WAAW,OAAA,EAAQ;AAAA,EAClC,CAAA,EAAG,CAAC,UAAA,EAAY,SAAS,CAAC,CAAA;AAE1B,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,UAAA,CAAW,KAAK,CAAA;AACvC,EAAA,OAAaA,iBAAA,CAAA,OAAA,CAAQ,OAAO,EAAE,GAAG,UAAA,EAAY,OAAM,CAAA,EAAI,CAAC,UAAA,EAAY,KAAK,CAAC,CAAA;AAC5E","file":"resource.cjs","sourcesContent":["import * as React from 'react'\nimport { useSyncExternalStore } from 'react'\nimport type { ReadonlyStore, Store } from '@iris-ui-kit/core'\n\n/**\n * Bridge a framework-agnostic `@iris-ui-kit/core` store into React reactivity.\n * Uses React 18's `useSyncExternalStore` — the contract is identical to the\n * one Vue uses via `ref + onMounted` and Solid uses via `createSignal`. The\n * **same** store can power Button, Popover, Dialog, etc. on any framework.\n */\nexport function useStore<T>(store: ReadonlyStore<T>): T {\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getState,\n    store.getState, // SSR fallback — same as client snapshot in our case.\n  )\n}\n\n/**\n * Subscribe to a DERIVED slice of a core store — the component re-renders only\n * when `selector(state)` changes per `isEqual` (default `Object.is`), not on\n * every store emission. Built on {@link Store.subscribeWith}. Inline closures\n * for `selector`/`isEqual` are fine (captured via refs; the subscription is not\n * re-created between renders).\n */\nexport function useStoreSelector<T, U>(\n  store: Store<T>,\n  selector: (state: T) => U,\n  isEqual?: (a: U, b: U) => boolean,\n): U {\n  const [slice, setSlice] = React.useState(() => selector(store.getState()))\n  const selRef = React.useRef(selector)\n  selRef.current = selector\n  const eqRef = React.useRef(isEqual)\n  eqRef.current = isEqual\n  React.useEffect(() => {\n    const read = (s: T): U => selRef.current(s)\n    const eq = (a: U, b: U): boolean => (eqRef.current ?? Object.is)(a, b)\n    // Re-sync in case the store moved between render and this effect.\n    setSlice((prev) => {\n      const next = read(store.getState())\n      return eq(prev, next) ? prev : next\n    })\n    return store.subscribeWith(read, setSlice, eq)\n  }, [store])\n  return slice\n}\n","import * as React from 'react'\nimport {\n  createResourceController,\n  type ResourceController,\n  type ResourceControllerConfig,\n  type ResourceState,\n} from '@iris-ui-kit/core'\nimport { useStore } from '../useStore'\n\nexport interface UseResourceController<T> extends ResourceController<T> {\n  /** The live resource state (rows, total, page, loading, selectedKeys). */\n  state: ResourceState<T>\n}\n\n/**\n * React bridge over the framework-agnostic {@link createResourceController} (L4\n * CRUD list composite). Creates the controller once, subscribes to its store,\n * and returns the controller plus its live `state`. A thin bridge — all logic\n * lives in `@iris-ui-kit/core`.\n *\n * The controller is constructed with `immediate: false` so no fetch fires during\n * React's (side-effect-free) render phase; the initial load is kicked from an\n * effect instead, and the controller is torn down on unmount so an in-flight\n * request never writes back to an unmounted component.\n */\nexport function useResourceController<T>(\n  config: ResourceControllerConfig<T>,\n): UseResourceController<T> {\n  const ref = React.useRef<ResourceController<T> | null>(null)\n  if (ref.current === null) ref.current = createResourceController({ ...config, immediate: false })\n  const controller = ref.current\n  const immediate = config.immediate !== false\n\n  // Construct-once controller: load on mount (when immediate) + tear down on\n  // unmount. `immediate` is captured at mount; it is not a reactive dependency.\n  React.useEffect(() => {\n    if (immediate) void controller.load()\n    return () => controller.destroy()\n  }, [controller, immediate])\n\n  const state = useStore(controller.store)\n  return React.useMemo(() => ({ ...controller, state }), [controller, state])\n}\n"]}

package/dist/resource.d.cts

@@ -0,0 +1,21 @@
+import { ResourceController, ResourceState, ResourceControllerConfig } from '@iris-ui-kit/core';
+export { DataViewColumn, MutateOptions, ResourceController, ResourceControllerConfig, ResourceQuery, ResourceState, createClientFetcher, createResourceController } from '@iris-ui-kit/core';
+
+interface UseResourceController<T> extends ResourceController<T> {
+    /** The live resource state (rows, total, page, loading, selectedKeys). */
+    state: ResourceState<T>;
+}
+/**
+ * React bridge over the framework-agnostic {@link createResourceController} (L4
+ * CRUD list composite). Creates the controller once, subscribes to its store,
+ * and returns the controller plus its live `state`. A thin bridge — all logic
+ * lives in `@iris-ui-kit/core`.
+ *
+ * The controller is constructed with `immediate: false` so no fetch fires during
+ * React's (side-effect-free) render phase; the initial load is kicked from an
+ * effect instead, and the controller is torn down on unmount so an in-flight
+ * request never writes back to an unmounted component.
+ */
+declare function useResourceController<T>(config: ResourceControllerConfig<T>): UseResourceController<T>;
+
+export { type UseResourceController, useResourceController };

package/dist/resource.d.ts

@@ -0,0 +1,21 @@
+import { ResourceController, ResourceState, ResourceControllerConfig } from '@iris-ui-kit/core';
+export { DataViewColumn, MutateOptions, ResourceController, ResourceControllerConfig, ResourceQuery, ResourceState, createClientFetcher, createResourceController } from '@iris-ui-kit/core';
+
+interface UseResourceController<T> extends ResourceController<T> {
+    /** The live resource state (rows, total, page, loading, selectedKeys). */
+    state: ResourceState<T>;
+}
+/**
+ * React bridge over the framework-agnostic {@link createResourceController} (L4
+ * CRUD list composite). Creates the controller once, subscribes to its store,
+ * and returns the controller plus its live `state`. A thin bridge — all logic
+ * lives in `@iris-ui-kit/core`.
+ *
+ * The controller is constructed with `immediate: false` so no fetch fires during
+ * React's (side-effect-free) render phase; the initial load is kicked from an
+ * effect instead, and the controller is torn down on unmount so an in-flight
+ * request never writes back to an unmounted component.
+ */
+declare function useResourceController<T>(config: ResourceControllerConfig<T>): UseResourceController<T>;
+
+export { type UseResourceController, useResourceController };

package/dist/resource.js

@@ -0,0 +1,5 @@
+'use client'
+export { createClientFetcher, createResourceController, useResourceController } from './chunk-TQ33XJIK.js';
+import './chunk-RZNYIFV2.js';
+//# sourceMappingURL=resource.js.map
+//# sourceMappingURL=resource.js.map

package/dist/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":";","file":"resource.js"}