@iris-ui-kit/vue 0.1.0

package/dist/modal-utils.d.cts

@@ -0,0 +1,43 @@
+import { Ref } from 'vue';
+
+interface UseFocusTrapOptions {
+    /** Element whose Tab key cycle is being trapped. */
+    container: Ref<HTMLElement | null>;
+    /** Whether the trap is currently active. */
+    active: Ref<boolean>;
+    /** Element to restore focus to when the trap deactivates. */
+    returnFocusTo?: Ref<HTMLElement | null | undefined>;
+    /** Whether to focus the first focusable element on activation. Default `true`. */
+    initialFocus?: boolean;
+}
+/**
+ * Constrain Tab / Shift+Tab focus traversal to descendants of `container`.
+ *
+ * Behavior on activation:
+ *   - Records the currently focused element.
+ *   - If `initialFocus !== false`, focuses the first focusable descendant
+ *     (or the container itself if there are none).
+ *
+ * Behavior while active:
+ *   - Tab on the last focusable element wraps to the first; Shift+Tab on
+ *     the first wraps to the last.
+ *
+ * Behavior on deactivation:
+ *   - Restores focus to `returnFocusTo?.value` if provided, else to the
+ *     element that was focused when the trap activated.
+ */
+declare function useFocusTrap(options: UseFocusTrapOptions): void;
+
+/**
+ * Lock the document body's scroll while `active` is true. Reference-counted
+ * so multiple stacked Dialogs cooperate. Restores prior `overflow` and
+ * `padding-right` (to compensate for the scrollbar gap) when the last lock
+ * releases. SSR-safe.
+ */
+declare function useBodyScrollLock(active: Ref<boolean>): void;
+/** Test-only: read the current lock count. */
+declare function __getBodyScrollLockCount(): number;
+/** Test-only: hard-reset the module-level lock state. */
+declare function __resetBodyScrollLock(): void;
+
+export { type UseFocusTrapOptions, __getBodyScrollLockCount, __resetBodyScrollLock, useBodyScrollLock, useFocusTrap };

package/dist/modal-utils.d.ts

@@ -0,0 +1,43 @@
+import { Ref } from 'vue';
+
+interface UseFocusTrapOptions {
+    /** Element whose Tab key cycle is being trapped. */
+    container: Ref<HTMLElement | null>;
+    /** Whether the trap is currently active. */
+    active: Ref<boolean>;
+    /** Element to restore focus to when the trap deactivates. */
+    returnFocusTo?: Ref<HTMLElement | null | undefined>;
+    /** Whether to focus the first focusable element on activation. Default `true`. */
+    initialFocus?: boolean;
+}
+/**
+ * Constrain Tab / Shift+Tab focus traversal to descendants of `container`.
+ *
+ * Behavior on activation:
+ *   - Records the currently focused element.
+ *   - If `initialFocus !== false`, focuses the first focusable descendant
+ *     (or the container itself if there are none).
+ *
+ * Behavior while active:
+ *   - Tab on the last focusable element wraps to the first; Shift+Tab on
+ *     the first wraps to the last.
+ *
+ * Behavior on deactivation:
+ *   - Restores focus to `returnFocusTo?.value` if provided, else to the
+ *     element that was focused when the trap activated.
+ */
+declare function useFocusTrap(options: UseFocusTrapOptions): void;
+
+/**
+ * Lock the document body's scroll while `active` is true. Reference-counted
+ * so multiple stacked Dialogs cooperate. Restores prior `overflow` and
+ * `padding-right` (to compensate for the scrollbar gap) when the last lock
+ * releases. SSR-safe.
+ */
+declare function useBodyScrollLock(active: Ref<boolean>): void;
+/** Test-only: read the current lock count. */
+declare function __getBodyScrollLockCount(): number;
+/** Test-only: hard-reset the module-level lock state. */
+declare function __resetBodyScrollLock(): void;
+
+export { type UseFocusTrapOptions, __getBodyScrollLockCount, __resetBodyScrollLock, useBodyScrollLock, useFocusTrap };

package/dist/modal-utils.js

@@ -0,0 +1,3 @@
+export { __getBodyScrollLockCount, __resetBodyScrollLock, useBodyScrollLock, useFocusTrap } from './chunk-XCNCIG2I.js';
+//# sourceMappingURL=modal-utils.js.map
+//# sourceMappingURL=modal-utils.js.map

package/dist/modal-utils.js.map

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

package/dist/motion.cjs

@@ -0,0 +1,88 @@
+'use strict';
+
+var vue = require('vue');
+var core = require('@iris-ui-kit/core');
+
+// src/motion/usePrefersReducedMotion.ts
+var QUERY = "(prefers-reduced-motion: reduce)";
+function read() {
+  if (typeof window === "undefined" || typeof window.matchMedia !== "function") return false;
+  return window.matchMedia(QUERY).matches;
+}
+function usePrefersReducedMotion() {
+  const reduced = vue.ref(read());
+  let mq = null;
+  const onChange = () => {
+    if (mq) reduced.value = mq.matches;
+  };
+  vue.onMounted(() => {
+    if (typeof window === "undefined" || typeof window.matchMedia !== "function") return;
+    mq = window.matchMedia(QUERY);
+    reduced.value = mq.matches;
+    mq.addEventListener?.("change", onChange);
+  });
+  vue.onBeforeUnmount(() => {
+    mq?.removeEventListener?.("change", onChange);
+  });
+  return reduced;
+}
+
+// src/motion/styles.ts
+var __DATA_STATE_STYLE_ID = "iris-data-state-styles";
+var DATA_STATE_CLASS = "iris-data-state-enter";
+var CSS = `
+@keyframes iris-data-state-enter {
+  from { opacity: 0; transform: translateY(4px); }
+  to { opacity: 1; transform: none; }
+}
+.${DATA_STATE_CLASS} {
+  animation: iris-data-state-enter var(--iris-duration-md, 200ms) ease;
+}
+@media (prefers-reduced-motion: reduce) {
+  .${DATA_STATE_CLASS} { animation: none; }
+}
+`.trim();
+var installed = false;
+function installDataStateStyles() {
+  if (installed) return;
+  if (typeof document === "undefined") return;
+  if (document.getElementById(__DATA_STATE_STYLE_ID)) {
+    installed = true;
+    return;
+  }
+  const el = document.createElement("style");
+  el.id = __DATA_STATE_STYLE_ID;
+  el.textContent = CSS;
+  document.head.appendChild(el);
+  installed = true;
+}
+function __resetDataStateStyles() {
+  installed = false;
+  if (typeof document !== "undefined") {
+    document.getElementById(__DATA_STATE_STYLE_ID)?.remove();
+  }
+}
+
+// src/motion/useDataState.ts
+function useDataState(input) {
+  vue.onMounted(installDataStateStyles);
+  const reduced = usePrefersReducedMotion();
+  const state = vue.computed(() => core.resolveDataState(input()));
+  return {
+    state,
+    isContent: vue.computed(() => state.value === "content"),
+    stateKey: state,
+    stateProps: vue.computed(() => ({
+      class: reduced.value ? "" : DATA_STATE_CLASS,
+      "data-iris-state": state.value
+    }))
+  };
+}
+
+exports.DATA_STATE_CLASS = DATA_STATE_CLASS;
+exports.__resetDataStateStyles = __resetDataStateStyles;
+exports.installDataStateStyles = installDataStateStyles;
+exports.useDataState = useDataState;
+exports.usePrefersReducedMotion = usePrefersReducedMotion;
+//# sourceMappingURL=motion.cjs.map
+//# sourceMappingURL=motion.cjs.map

package/dist/motion.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/motion/usePrefersReducedMotion.ts","../src/motion/styles.ts","../src/motion/useDataState.ts"],"names":["ref","onMounted","onBeforeUnmount","computed","resolveDataState"],"mappings":";;;;;;AAEA,IAAM,KAAA,GAAQ,kCAAA;AAEd,SAAS,IAAA,GAAgB;AACvB,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,OAAO,MAAA,CAAO,UAAA,KAAe,YAAY,OAAO,KAAA;AACrF,EAAA,OAAO,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA,CAAE,OAAA;AAClC;AAOO,SAAS,uBAAA,GAAwC;AACtD,EAAA,MAAM,OAAA,GAAUA,OAAA,CAAa,IAAA,EAAM,CAAA;AACnC,EAAA,IAAI,EAAA,GAA4B,IAAA;AAChC,EAAA,MAAM,WAAW,MAAM;AACrB,IAAA,IAAI,EAAA,EAAI,OAAA,CAAQ,KAAA,GAAQ,EAAA,CAAG,OAAA;AAAA,EAC7B,CAAA;AAEA,EAAAC,aAAA,CAAU,MAAM;AACd,IAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,OAAO,MAAA,CAAO,eAAe,UAAA,EAAY;AAC9E,IAAA,EAAA,GAAK,MAAA,CAAO,WAAW,KAAK,CAAA;AAC5B,IAAA,OAAA,CAAQ,QAAQ,EAAA,CAAG,OAAA;AACnB,IAAA,EAAA,CAAG,gBAAA,GAAmB,UAAU,QAAQ,CAAA;AAAA,EAC1C,CAAC,CAAA;AACD,EAAAC,mBAAA,CAAgB,MAAM;AACpB,IAAA,EAAA,EAAI,mBAAA,GAAsB,UAAU,QAAQ,CAAA;AAAA,EAC9C,CAAC,CAAA;AAED,EAAA,OAAO,OAAA;AACT;;;AChCO,IAAM,qBAAA,GAAwB,wBAAA;AAG9B,IAAM,gBAAA,GAAmB;AAEhC,IAAM,GAAA,GAAM;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA,EAKT,gBAAgB,CAAA;AAAA;AAAA;AAAA;AAAA,GAAA,EAId,gBAAgB,CAAA;AAAA;AAAA,CAAA,CAEnB,IAAA,EAAK;AAEP,IAAI,SAAA,GAAY,KAAA;AAGT,SAAS,sBAAA,GAA+B;AAC7C,EAAA,IAAI,SAAA,EAAW;AACf,EAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACrC,EAAA,IAAI,QAAA,CAAS,cAAA,CAAe,qBAAqB,CAAA,EAAG;AAClD,IAAA,SAAA,GAAY,IAAA;AACZ,IAAA;AAAA,EACF;AACA,EAAA,MAAM,EAAA,GAAK,QAAA,CAAS,aAAA,CAAc,OAAO,CAAA;AACzC,EAAA,EAAA,CAAG,EAAA,GAAK,qBAAA;AACR,EAAA,EAAA,CAAG,WAAA,GAAc,GAAA;AACjB,EAAA,QAAA,CAAS,IAAA,CAAK,YAAY,EAAE,CAAA;AAC5B,EAAA,SAAA,GAAY,IAAA;AACd;AAEO,SAAS,sBAAA,GAA+B;AAC7C,EAAA,SAAA,GAAY,KAAA;AACZ,EAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACnC,IAAA,QAAA,CAAS,cAAA,CAAe,qBAAqB,CAAA,EAAG,MAAA,EAAO;AAAA,EACzD;AACF;;;ACTO,SAAS,aAAa,KAAA,EAAiD;AAC5E,EAAAD,cAAU,sBAAsB,CAAA;AAChC,EAAA,MAAM,UAAU,uBAAA,EAAwB;AACxC,EAAA,MAAM,QAAQE,YAAA,CAAS,MAAMC,qBAAA,CAAiB,KAAA,EAAO,CAAC,CAAA;AACtD,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA,SAAA,EAAWD,YAAA,CAAS,MAAM,KAAA,CAAM,UAAU,SAAS,CAAA;AAAA,IACnD,QAAA,EAAU,KAAA;AAAA,IACV,UAAA,EAAYA,aAAS,OAAO;AAAA,MAC1B,KAAA,EAAO,OAAA,CAAQ,KAAA,GAAQ,EAAA,GAAK,gBAAA;AAAA,MAC5B,mBAAmB,KAAA,CAAM;AAAA,KAC3B,CAAE;AAAA,GACJ;AACF","file":"motion.cjs","sourcesContent":["import { onBeforeUnmount, onMounted, ref, type Ref } from 'vue'\n\nconst QUERY = '(prefers-reduced-motion: reduce)'\n\nfunction read(): boolean {\n  if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') return false\n  return window.matchMedia(QUERY).matches\n}\n\n/**\n * Reactive `prefers-reduced-motion` flag. Returns `false` where `matchMedia`\n * is unavailable (SSR / older jsdom) so animation is the safe default only when\n * the user has not asked to reduce it.\n */\nexport function usePrefersReducedMotion(): Ref<boolean> {\n  const reduced = ref<boolean>(read())\n  let mq: MediaQueryList | null = null\n  const onChange = () => {\n    if (mq) reduced.value = mq.matches\n  }\n\n  onMounted(() => {\n    if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') return\n    mq = window.matchMedia(QUERY)\n    reduced.value = mq.matches\n    mq.addEventListener?.('change', onChange)\n  })\n  onBeforeUnmount(() => {\n    mq?.removeEventListener?.('change', onChange)\n  })\n\n  return reduced\n}\n","export const __DATA_STATE_STYLE_ID = 'iris-data-state-styles'\n\n/** Class applied to a state node so its entry cross-fades in. */\nexport const DATA_STATE_CLASS = 'iris-data-state-enter'\n\nconst CSS = `\n@keyframes iris-data-state-enter {\n  from { opacity: 0; transform: translateY(4px); }\n  to { opacity: 1; transform: none; }\n}\n.${DATA_STATE_CLASS} {\n  animation: iris-data-state-enter var(--iris-duration-md, 200ms) ease;\n}\n@media (prefers-reduced-motion: reduce) {\n  .${DATA_STATE_CLASS} { animation: none; }\n}\n`.trim()\n\nlet installed = false\n\n/** Idempotently inject the data-state enter keyframes (SSR-safe no-op). */\nexport function installDataStateStyles(): void {\n  if (installed) return\n  if (typeof document === 'undefined') return\n  if (document.getElementById(__DATA_STATE_STYLE_ID)) {\n    installed = true\n    return\n  }\n  const el = document.createElement('style')\n  el.id = __DATA_STATE_STYLE_ID\n  el.textContent = CSS\n  document.head.appendChild(el)\n  installed = true\n}\n\nexport function __resetDataStateStyles(): void {\n  installed = false\n  if (typeof document !== 'undefined') {\n    document.getElementById(__DATA_STATE_STYLE_ID)?.remove()\n  }\n}\n","import { computed, onMounted, type ComputedRef } from 'vue'\nimport { resolveDataState, type DataState, type DataStateInput } from '@iris-ui-kit/core'\nimport { DATA_STATE_CLASS, installDataStateStyles } from './styles'\nimport { usePrefersReducedMotion } from './usePrefersReducedMotion'\n\nexport interface DataStateNodeProps {\n  class: string\n  'data-iris-state': DataState\n}\n\nexport interface UseDataStateReturn {\n  /** Resolved state (`error → loading → empty → content` precedence). */\n  state: ComputedRef<DataState>\n  /** `true` when the host should render its real content. */\n  isContent: ComputedRef<boolean>\n  /** Use as the vnode `key` of the state node so the enter animation replays on each transition. */\n  stateKey: ComputedRef<DataState>\n  /** Spread onto the rendered loading/error/empty node. */\n  stateProps: ComputedRef<DataStateNodeProps>\n}\n\n/**\n * State-transition + entry-animation composable for data components. Resolves\n * the active {@link DataState} from a reactive `{ loading, error, empty }`\n * getter, and returns props for the state node that (a) re-key on every\n * transition so the cross-fade replays and (b) drop the animation class when\n * the user prefers reduced motion.\n *\n * The framework-agnostic precedence lives in `@iris-ui-kit/core`'s\n * {@link resolveDataState}; this composable is the thin Vue animation bridge.\n */\nexport function useDataState(input: () => DataStateInput): UseDataStateReturn {\n  onMounted(installDataStateStyles)\n  const reduced = usePrefersReducedMotion()\n  const state = computed(() => resolveDataState(input()))\n  return {\n    state,\n    isContent: computed(() => state.value === 'content'),\n    stateKey: state,\n    stateProps: computed(() => ({\n      class: reduced.value ? '' : DATA_STATE_CLASS,\n      'data-iris-state': state.value,\n    })),\n  }\n}\n"]}

package/dist/motion.d.cts

@@ -0,0 +1,43 @@
+import { Ref, ComputedRef } from 'vue';
+import { DataState, DataStateInput } from '@iris-ui-kit/core';
+
+/**
+ * Reactive `prefers-reduced-motion` flag. Returns `false` where `matchMedia`
+ * is unavailable (SSR / older jsdom) so animation is the safe default only when
+ * the user has not asked to reduce it.
+ */
+declare function usePrefersReducedMotion(): Ref<boolean>;
+
+interface DataStateNodeProps {
+    class: string;
+    'data-iris-state': DataState;
+}
+interface UseDataStateReturn {
+    /** Resolved state (`error → loading → empty → content` precedence). */
+    state: ComputedRef<DataState>;
+    /** `true` when the host should render its real content. */
+    isContent: ComputedRef<boolean>;
+    /** Use as the vnode `key` of the state node so the enter animation replays on each transition. */
+    stateKey: ComputedRef<DataState>;
+    /** Spread onto the rendered loading/error/empty node. */
+    stateProps: ComputedRef<DataStateNodeProps>;
+}
+/**
+ * State-transition + entry-animation composable for data components. Resolves
+ * the active {@link DataState} from a reactive `{ loading, error, empty }`
+ * getter, and returns props for the state node that (a) re-key on every
+ * transition so the cross-fade replays and (b) drop the animation class when
+ * the user prefers reduced motion.
+ *
+ * The framework-agnostic precedence lives in `@iris-ui-kit/core`'s
+ * {@link resolveDataState}; this composable is the thin Vue animation bridge.
+ */
+declare function useDataState(input: () => DataStateInput): UseDataStateReturn;
+
+/** Class applied to a state node so its entry cross-fades in. */
+declare const DATA_STATE_CLASS = "iris-data-state-enter";
+/** Idempotently inject the data-state enter keyframes (SSR-safe no-op). */
+declare function installDataStateStyles(): void;
+declare function __resetDataStateStyles(): void;
+
+export { DATA_STATE_CLASS, type DataStateNodeProps, type UseDataStateReturn, __resetDataStateStyles, installDataStateStyles, useDataState, usePrefersReducedMotion };

package/dist/motion.d.ts

@@ -0,0 +1,43 @@
+import { Ref, ComputedRef } from 'vue';
+import { DataState, DataStateInput } from '@iris-ui-kit/core';
+
+/**
+ * Reactive `prefers-reduced-motion` flag. Returns `false` where `matchMedia`
+ * is unavailable (SSR / older jsdom) so animation is the safe default only when
+ * the user has not asked to reduce it.
+ */
+declare function usePrefersReducedMotion(): Ref<boolean>;
+
+interface DataStateNodeProps {
+    class: string;
+    'data-iris-state': DataState;
+}
+interface UseDataStateReturn {
+    /** Resolved state (`error → loading → empty → content` precedence). */
+    state: ComputedRef<DataState>;
+    /** `true` when the host should render its real content. */
+    isContent: ComputedRef<boolean>;
+    /** Use as the vnode `key` of the state node so the enter animation replays on each transition. */
+    stateKey: ComputedRef<DataState>;
+    /** Spread onto the rendered loading/error/empty node. */
+    stateProps: ComputedRef<DataStateNodeProps>;
+}
+/**
+ * State-transition + entry-animation composable for data components. Resolves
+ * the active {@link DataState} from a reactive `{ loading, error, empty }`
+ * getter, and returns props for the state node that (a) re-key on every
+ * transition so the cross-fade replays and (b) drop the animation class when
+ * the user prefers reduced motion.
+ *
+ * The framework-agnostic precedence lives in `@iris-ui-kit/core`'s
+ * {@link resolveDataState}; this composable is the thin Vue animation bridge.
+ */
+declare function useDataState(input: () => DataStateInput): UseDataStateReturn;
+
+/** Class applied to a state node so its entry cross-fades in. */
+declare const DATA_STATE_CLASS = "iris-data-state-enter";
+/** Idempotently inject the data-state enter keyframes (SSR-safe no-op). */
+declare function installDataStateStyles(): void;
+declare function __resetDataStateStyles(): void;
+
+export { DATA_STATE_CLASS, type DataStateNodeProps, type UseDataStateReturn, __resetDataStateStyles, installDataStateStyles, useDataState, usePrefersReducedMotion };

package/dist/motion.js

@@ -0,0 +1,3 @@
+export { DATA_STATE_CLASS, __resetDataStateStyles, installDataStateStyles, useDataState, usePrefersReducedMotion } from './chunk-S43IHHBU.js';
+//# sourceMappingURL=motion.js.map
+//# sourceMappingURL=motion.js.map

package/dist/motion.js.map

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

package/dist/provider.cjs

@@ -0,0 +1,272 @@
+'use strict';
+
+var vue = require('vue');
+var core = require('@iris-ui-kit/core');
+var theme = require('@iris-ui-kit/theme');
+var skins = require('@iris-ui-kit/skins');
+
+// src/provider/IrisProvider.ts
+var IrisThemeKey = /* @__PURE__ */ Symbol("IrisTheme");
+var ThemeProvider = vue.defineComponent({
+  name: "IrisThemeProvider",
+  props: {
+    store: {
+      type: Object,
+      required: true
+    },
+    target: {
+      type: Object,
+      default: null
+    },
+    /** Writing direction; sets `dir` on the target for RTL. Default `'ltr'`. */
+    dir: {
+      type: String,
+      default: "ltr"
+    },
+    /** CSP nonce for injected inline stylesheets. */
+    cspNonce: {
+      type: String,
+      default: void 0
+    }
+  },
+  setup(props, { slots }) {
+    const current = vue.ref(props.store.store.getState());
+    const unsubscribe = props.store.store.subscribe((next) => {
+      current.value = next;
+    });
+    let applied = null;
+    let dirApplied = null;
+    const targetEl = () => props.target ?? document.documentElement;
+    const applyCurrent = () => {
+      applied?.revert();
+      applied = theme.applyTheme(current.value, targetEl());
+    };
+    const applyDir = () => {
+      dirApplied?.revert();
+      dirApplied = theme.applyDirection(props.dir, targetEl());
+    };
+    vue.onMounted(() => {
+      theme.injectGlobalStyles(props.cspNonce);
+      applyCurrent();
+      applyDir();
+    });
+    vue.watch(current, () => {
+      if (applied) applyCurrent();
+    });
+    vue.watch(
+      () => props.dir,
+      () => {
+        if (dirApplied) applyDir();
+      }
+    );
+    vue.onBeforeUnmount(() => {
+      unsubscribe();
+      applied?.revert();
+      applied = null;
+      dirApplied?.revert();
+      dirApplied = null;
+    });
+    vue.provide(IrisThemeKey, { store: props.store, current, dir: vue.computed(() => props.dir) });
+    return () => slots.default?.();
+  }
+});
+var IrisSkinKey = /* @__PURE__ */ Symbol("IrisSkin");
+var SkinProvider = vue.defineComponent({
+  name: "IrisSkinProvider",
+  props: {
+    engine: { type: Object, required: true },
+    target: { type: Object, default: null },
+    cspNonce: { type: String, default: void 0 }
+  },
+  setup(props, { slots }) {
+    const current = vue.ref(props.engine.current());
+    const unsubscribe = props.engine.subscribe((next) => {
+      current.value = next;
+    });
+    let applied = null;
+    const targetEl = () => props.target ?? document.documentElement;
+    const apply = () => {
+      applied?.revert();
+      applied = skins.applySkin(current.value, targetEl());
+    };
+    vue.onMounted(() => {
+      theme.injectGlobalStyles(props.cspNonce);
+      apply();
+    });
+    vue.watch(current, () => {
+      if (applied) apply();
+    });
+    vue.onBeforeUnmount(() => {
+      unsubscribe();
+      applied?.revert();
+      applied = null;
+    });
+    vue.provide(IrisSkinKey, { engine: props.engine, current });
+    return () => slots.default?.();
+  }
+});
+
+// src/i18n/context.ts
+var I18nInjectionKey = /* @__PURE__ */ Symbol("IrisI18n");
+
+// src/i18n/I18nProvider.ts
+var IrisI18nProvider = vue.defineComponent({
+  name: "IrisI18nProvider",
+  props: {
+    locale: { type: String, default: void 0 },
+    messages: { type: Object, default: void 0 },
+    i18n: { type: Object, default: void 0 },
+    /**
+     * When set, the locale's writing direction ({@link localeDirection}) is
+     * applied to `directionTarget` (`dir` + `data-iris-dir`) and `<html lang>`
+     * is set whenever `locale` changes — so "set locale → flip direction +
+     * announce language" needs no manual wiring. Off by default so it never
+     * fights an explicit `<ThemeProvider dir>`. Reverts on unmount.
+     */
+    autoDirection: { type: Boolean, default: false },
+    /** Element to receive dir/lang when `autoDirection` is set. Defaults to `document.documentElement`. */
+    directionTarget: { type: Object, default: void 0 }
+  },
+  setup(props, { slots }) {
+    const instance = props.i18n ?? core.createI18n({ locale: props.locale, messages: props.messages });
+    vue.provide(I18nInjectionKey, instance);
+    if (!props.i18n) {
+      vue.watch(
+        () => props.locale,
+        (locale) => {
+          if (locale) instance.setLocale(locale);
+        }
+      );
+      vue.watch(
+        () => props.messages,
+        (messages) => {
+          if (messages) instance.setMessages(messages);
+        }
+      );
+    }
+    let revertDirection = null;
+    vue.watch(
+      () => [props.autoDirection, props.locale, props.directionTarget],
+      ([autoDirection, locale]) => {
+        revertDirection?.();
+        revertDirection = null;
+        if (!autoDirection || !locale || typeof document === "undefined") return;
+        const el = props.directionTarget ?? document.documentElement;
+        const applied = theme.applyDirection(core.localeDirection(locale), el);
+        const prevLang = el.getAttribute("lang");
+        el.setAttribute("lang", locale);
+        revertDirection = () => {
+          applied.revert();
+          if (prevLang === null) el.removeAttribute("lang");
+          else el.setAttribute("lang", prevLang);
+        };
+      },
+      { immediate: true }
+    );
+    vue.onScopeDispose(() => {
+      revertDirection?.();
+      revertDirection = null;
+    });
+    return () => slots.default?.();
+  }
+});
+
+// src/provider/context.ts
+var PluginStoreContextKey = /* @__PURE__ */ Symbol("IrisPluginStore");
+
+// src/provider/IrisProvider.ts
+var DEFAULT_LOCALE = "en-US";
+var IrisProvider = vue.defineComponent({
+  name: "IrisProvider",
+  props: {
+    theme: { type: Object, default: void 0 },
+    skin: { type: Object, default: void 0 },
+    dir: { type: String, default: void 0 },
+    locale: { type: String, default: void 0 },
+    messages: { type: Object, default: void 0 },
+    plugins: { type: Array, default: void 0 },
+    target: { type: Object, default: null }
+  },
+  setup(props, { slots }) {
+    const collected = core.runPlugins(props.plugins ?? []);
+    let applied = null;
+    vue.onMounted(() => {
+      if (typeof document === "undefined") return;
+      const el = props.target ?? document.documentElement;
+      applied = theme.applyCssVars(Object.entries(collected.tokens), el);
+    });
+    vue.onBeforeUnmount(() => {
+      applied?.revert();
+      applied = null;
+      collected.teardown();
+    });
+    vue.provide(PluginStoreContextKey, {
+      stores: collected.stores,
+      installed: new Set((props.plugins ?? []).map((p) => p.name))
+    });
+    return () => {
+      const locale = props.locale ?? DEFAULT_LOCALE;
+      const messages = { ...collected.messages[locale], ...props.messages ?? {} };
+      let tree = vue.h(
+        IrisI18nProvider,
+        { locale: props.locale, messages },
+        { default: () => slots.default?.() }
+      );
+      if (props.skin) {
+        tree = vue.h(
+          SkinProvider,
+          { engine: props.skin, target: props.target },
+          { default: () => tree }
+        );
+      }
+      if (props.theme) {
+        tree = vue.h(
+          ThemeProvider,
+          { store: props.theme, target: props.target, dir: props.dir ?? "ltr" },
+          { default: () => tree }
+        );
+      }
+      return tree;
+    };
+  }
+});
+function usePlugin(name) {
+  const ctx = vue.inject(PluginStoreContextKey, null);
+  return ctx ? ctx.installed.has(name) : false;
+}
+var warnedKeys = /* @__PURE__ */ new Map();
+function usePluginStore(nsOrKey, key) {
+  const ctx = vue.inject(PluginStoreContextKey, null);
+  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: 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.PluginStoreContextKey = PluginStoreContextKey;
+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/theme/ThemeProvider.ts","../src/skins/SkinProvider.ts","../src/i18n/context.ts","../src/i18n/I18nProvider.ts","../src/provider/context.ts","../src/provider/IrisProvider.ts","../src/provider/hooks.ts"],"names":["defineComponent","ref","applyTheme","applyDirection","onMounted","injectGlobalStyles","watch","onBeforeUnmount","provide","computed","applySkin","createI18n","localeDirection","onScopeDispose","runPlugins","applyCssVars","h","inject"],"mappings":"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","file":"provider.cjs","sourcesContent":["import {\n  computed,\n  defineComponent,\n  inject,\n  onBeforeUnmount,\n  onMounted,\n  provide,\n  ref,\n  watch,\n  type ComputedRef,\n  type InjectionKey,\n  type PropType,\n  type Ref,\n} from 'vue'\nimport {\n  applyDirection,\n  applyTheme,\n  injectGlobalStyles,\n  type ApplyDirectionResult,\n  type ApplyThemeResult,\n  type Direction,\n  type ThemeStore,\n} from '@iris-ui-kit/theme'\nimport type { IrisTheme } from '@iris-ui-kit/tokens'\n\nexport interface IrisThemeContext {\n  store: ThemeStore\n  current: Ref<IrisTheme>\n  dir: ComputedRef<Direction>\n}\n\nexport const IrisThemeKey: InjectionKey<IrisThemeContext> = Symbol('IrisTheme')\n\n/**\n * Renderless provider that:\n * 1. exposes the theme store to descendants via `provide`,\n * 2. applies the current theme to a target element on mount and on change,\n * 3. reverts the inline custom properties on unmount.\n *\n * `target` defaults to `document.documentElement`. Pass an element ref to\n * scope a theme to a subtree.\n */\nexport const ThemeProvider = defineComponent({\n  name: 'IrisThemeProvider',\n  props: {\n    store: {\n      type: Object as PropType<ThemeStore>,\n      required: true,\n    },\n    target: {\n      type: Object as PropType<HTMLElement | null>,\n      default: null,\n    },\n    /** Writing direction; sets `dir` on the target for RTL. Default `'ltr'`. */\n    dir: {\n      type: String as PropType<Direction>,\n      default: 'ltr',\n    },\n    /** CSP nonce for injected inline stylesheets. */\n    cspNonce: {\n      type: String,\n      default: undefined,\n    },\n  },\n  setup(props, { slots }) {\n    const current = ref(props.store.store.getState()) as Ref<IrisTheme>\n    const unsubscribe = props.store.store.subscribe((next) => {\n      current.value = next\n    })\n\n    let applied: ApplyThemeResult | null = null\n    let dirApplied: ApplyDirectionResult | null = null\n\n    const targetEl = () => props.target ?? document.documentElement\n\n    const applyCurrent = () => {\n      applied?.revert()\n      applied = applyTheme(current.value, targetEl())\n    }\n\n    const applyDir = () => {\n      dirApplied?.revert()\n      dirApplied = applyDirection(props.dir, targetEl())\n    }\n\n    onMounted(() => {\n      injectGlobalStyles(props.cspNonce)\n      applyCurrent()\n      applyDir()\n    })\n\n    watch(current, () => {\n      if (applied) applyCurrent()\n    })\n\n    watch(\n      () => props.dir,\n      () => {\n        if (dirApplied) applyDir()\n      },\n    )\n\n    onBeforeUnmount(() => {\n      unsubscribe()\n      applied?.revert()\n      applied = null\n      dirApplied?.revert()\n      dirApplied = null\n    })\n\n    provide(IrisThemeKey, { store: props.store, current, dir: computed(() => props.dir) })\n\n    return () => slots.default?.()\n  },\n})\n\nexport function useThemeContext(): IrisThemeContext {\n  const ctx = inject(IrisThemeKey)\n  if (!ctx) {\n    throw new Error('[iris-ui] useTheme(): no <ThemeProvider> ancestor found')\n  }\n  return ctx\n}\n\n/**\n * Current writing direction (`'ltr'` / `'rtl'`) from the nearest\n * `<ThemeProvider>`, or a static `'ltr'` ref when there is none.\n */\nexport function useDirection(): ComputedRef<Direction> {\n  const ctx = inject(IrisThemeKey, null)\n  return ctx ? ctx.dir : computed(() => 'ltr' as Direction)\n}\n","import {\n  defineComponent,\n  inject,\n  onBeforeUnmount,\n  onMounted,\n  provide,\n  ref,\n  watch,\n  type InjectionKey,\n  type PropType,\n  type Ref,\n} from 'vue'\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'\n\nexport interface IrisSkinContext {\n  engine: SkinEngine\n  current: Ref<ResolvedSkin>\n}\n\nexport const IrisSkinKey: InjectionKey<IrisSkinContext> = Symbol('IrisSkin')\n\n/**\n * Renderless provider mirroring `<IrisThemeProvider>` for skins: subscribes to\n * the engine store, applies/reverts the resolved skin on the target element,\n * and provides the engine + current skin to descendants. Zero skin logic.\n */\nexport const SkinProvider = defineComponent({\n  name: 'IrisSkinProvider',\n  props: {\n    engine: { type: Object as PropType<SkinEngine>, required: true },\n    target: { type: Object as PropType<HTMLElement | null>, default: null },\n    cspNonce: { type: String, default: undefined },\n  },\n  setup(props, { slots }) {\n    const current = ref(props.engine.current()) as Ref<ResolvedSkin>\n    const unsubscribe = props.engine.subscribe((next) => {\n      current.value = next\n    })\n\n    let applied: ApplySkinResult | null = null\n    const targetEl = () => props.target ?? document.documentElement\n    const apply = () => {\n      applied?.revert()\n      applied = applySkin(current.value, targetEl())\n    }\n\n    onMounted(() => {\n      injectGlobalStyles(props.cspNonce)\n      apply()\n    })\n    watch(current, () => {\n      if (applied) apply()\n    })\n    onBeforeUnmount(() => {\n      unsubscribe()\n      applied?.revert()\n      applied = null\n    })\n\n    provide(IrisSkinKey, { engine: props.engine, current })\n    return () => slots.default?.()\n  },\n})\n\nexport function useSkinContext(): IrisSkinContext {\n  const ctx = inject(IrisSkinKey)\n  if (!ctx) throw new Error('[iris-ui] useSkin(): no <SkinProvider> ancestor found')\n  return ctx\n}\n","import { type InjectionKey } from 'vue'\nimport type { I18n } from '@iris-ui-kit/core'\n\n/** Injection key carrying the active {@link I18n} instance to `useI18n`. */\nexport const I18nInjectionKey: InjectionKey<I18n> = Symbol('IrisI18n')\n","import { defineComponent, onScopeDispose, provide, watch, type PropType } from 'vue'\nimport { createI18n, localeDirection, type I18n, type I18nMessages } from '@iris-ui-kit/core'\nimport { applyDirection } from '@iris-ui-kit/theme'\nimport { I18nInjectionKey } from './context'\n\n/**\n * Makes a locale + message dictionary available to descendant components via\n * `useI18n`. Pass `locale` / `messages` (an instance is created and kept in\n * sync) or a pre-built `i18n` instance you control externally. Renderless:\n * renders its default slot.\n */\nexport const IrisI18nProvider = defineComponent({\n  name: 'IrisI18nProvider',\n  props: {\n    locale: { type: String, default: undefined },\n    messages: { type: Object as PropType<I18nMessages>, default: undefined },\n    i18n: { type: Object as PropType<I18n>, default: undefined },\n    /**\n     * When set, the locale's writing direction ({@link localeDirection}) is\n     * applied to `directionTarget` (`dir` + `data-iris-dir`) and `<html lang>`\n     * is set whenever `locale` changes — so \"set locale → flip direction +\n     * announce language\" needs no manual wiring. Off by default so it never\n     * fights an explicit `<ThemeProvider dir>`. Reverts on unmount.\n     */\n    autoDirection: { type: Boolean, default: false },\n    /** Element to receive dir/lang when `autoDirection` is set. Defaults to `document.documentElement`. */\n    directionTarget: { type: Object as PropType<HTMLElement | null>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const instance = props.i18n ?? createI18n({ locale: props.locale, messages: props.messages })\n    provide(I18nInjectionKey, instance)\n\n    if (!props.i18n) {\n      watch(\n        () => props.locale,\n        (locale) => {\n          if (locale) instance.setLocale(locale)\n        },\n      )\n      watch(\n        () => props.messages,\n        (messages) => {\n          if (messages) instance.setMessages(messages)\n        },\n      )\n    }\n\n    // Auto-apply writing direction + `lang` from the active locale (opt-in).\n    let revertDirection: (() => void) | null = null\n    watch(\n      () => [props.autoDirection, props.locale, props.directionTarget] as const,\n      ([autoDirection, locale]) => {\n        revertDirection?.()\n        revertDirection = null\n        if (!autoDirection || !locale || typeof document === 'undefined') return\n        const el = props.directionTarget ?? document.documentElement\n        const applied = applyDirection(localeDirection(locale), el)\n        const prevLang = el.getAttribute('lang')\n        el.setAttribute('lang', locale)\n        revertDirection = () => {\n          applied.revert()\n          if (prevLang === null) el.removeAttribute('lang')\n          else el.setAttribute('lang', prevLang)\n        }\n      },\n      { immediate: true },\n    )\n    onScopeDispose(() => {\n      revertDirection?.()\n      revertDirection = null\n    })\n\n    return () => slots.default?.()\n  },\n})\n","import { type InjectionKey } from 'vue'\n\n/**\n * Shape carried by the plugin-store context: the live store instances collected\n * from every installed plugin, plus the set of installed plugin names. Surfaced\n * to descendants through `usePluginStore` / `usePlugin`.\n */\nexport interface PluginStoreContext {\n  stores: Map<string, unknown>\n  installed: Set<string>\n}\n\n/**\n * Injection key for the {@link PluginStoreContext}. The name ends in `Key` (and\n * the type in `Context`) so the manifest's discover step never mistakes it for a\n * component export.\n */\nexport const PluginStoreContextKey: InjectionKey<PluginStoreContext> = Symbol('IrisPluginStore')\n","import {\n  defineComponent,\n  h,\n  onBeforeUnmount,\n  onMounted,\n  provide,\n  type PropType,\n  type VNode,\n} from 'vue'\nimport { runPlugins, type IrisPlugin } from '@iris-ui-kit/core'\nimport { applyCssVars, type ApplyCssVarsResult, type ThemeStore } 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 { PluginStoreContextKey } from './context'\n\nconst DEFAULT_LOCALE = 'en-US'\n\n/** Public prop surface of {@link IrisProvider}. */\nexport interface IrisProviderProps {\n  /** Theme store; when present the inner `ThemeProvider` wraps the subtree. */\n  theme?: ThemeStore\n  /** Skin engine; when present the inner `SkinProvider` wraps the subtree. */\n  skin?: SkinEngine\n  /** Writing direction, forwarded to `ThemeProvider` when a theme is given. */\n  dir?: 'ltr' | 'rtl'\n  /** Active BCP-47 locale; defaults to `'en-US'`. */\n  locale?: string\n  /** User messages — merged OVER plugin-registered messages (user wins). */\n  messages?: Record<string, string>\n  /** Plugins to install; their tokens / messages / stores are collected once. */\n  plugins?: IrisPlugin[]\n  /** Element receiving the plugin token layer; defaults to `documentElement`. */\n  target?: HTMLElement | null\n}\n\n/**\n * The single unified Iris entry point. Runs `plugins` through the core\n * `runPlugins` collector and wires the result into the theme (tokens), i18n\n * (messages) and a plugin-store context, composing the existing per-framework\n * providers. A thin bridge — the real logic lives in `@iris-ui-kit/core`.\n *\n * Render order when present: Theme → Skin → I18n → PluginContext → children.\n */\nexport const IrisProvider = defineComponent({\n  name: 'IrisProvider',\n  props: {\n    theme: { type: Object as PropType<ThemeStore>, default: undefined },\n    skin: { type: Object as PropType<SkinEngine>, default: undefined },\n    dir: { type: String as PropType<'ltr' | 'rtl'>, default: undefined },\n    locale: { type: String, default: undefined },\n    messages: { type: Object as PropType<Record<string, string>>, default: undefined },\n    plugins: { type: Array as PropType<IrisPlugin[]>, default: undefined },\n    target: { type: Object as PropType<HTMLElement | null>, default: null },\n  },\n  setup(props, { slots }) {\n    // Sync, pure, deterministic — computed once per setup over `plugins`.\n    const collected = runPlugins(props.plugins ?? [])\n\n    // tokens → additive CSS-var layer over the active theme; reverted on unmount.\n    let applied: ApplyCssVarsResult | null = null\n    onMounted(() => {\n      if (typeof document === 'undefined') return\n      const el = props.target ?? document.documentElement\n      applied = applyCssVars(Object.entries(collected.tokens), el)\n    })\n    onBeforeUnmount(() => {\n      applied?.revert()\n      applied = null\n      // Run plugin teardowns on unmount so eager stores / subscriptions /\n      // timers don't leak. Idempotent and safe with no plugins.\n      collected.teardown()\n    })\n\n    // stores + installed names → PluginStoreContext.\n    provide(PluginStoreContextKey, {\n      stores: collected.stores,\n      installed: new Set((props.plugins ?? []).map((p) => p.name)),\n    })\n\n    return () => {\n      const locale = props.locale ?? DEFAULT_LOCALE\n      // Plugin messages as BASE, user messages WIN.\n      const messages = { ...collected.messages[locale], ...(props.messages ?? {}) }\n\n      // I18n always renders, wrapping children.\n      let tree: VNode = h(\n        IrisI18nProvider,\n        { locale: props.locale, messages },\n        { default: () => slots.default?.() },\n      )\n      // Skin wraps only when a `skin` engine is supplied.\n      if (props.skin) {\n        tree = h(\n          SkinProvider,\n          { engine: props.skin, target: props.target },\n          { default: () => tree },\n        )\n      }\n      // Theme wraps only when a `theme` store is supplied.\n      if (props.theme) {\n        tree = h(\n          ThemeProvider,\n          { store: props.theme, target: props.target, dir: props.dir ?? 'ltr' },\n          { default: () => tree },\n        )\n      }\n      return tree\n    }\n  },\n})\n","import { inject } from 'vue'\nimport { PluginStoreContextKey } from './context'\n\n/** Whether the named plugin is installed by the nearest `<IrisProvider>`. */\nexport function usePlugin(name: string): boolean {\n  const ctx = inject(PluginStoreContextKey, null)\n  return ctx ? ctx.installed.has(name) : false\n}\n\n// Tracks ambiguous store key warnings to avoid spamming the console.\nconst warnedKeys = new Map<string, boolean>()\n\n/**\n * Read a plugin-registered store by `key` (backward-compatible single-arg form).\n * Throws a clear error when used outside an `<IrisProvider>`.\n */\nexport function usePluginStore<T>(key: string): T\n\n/**\n * Read a plugin-registered store by `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 = inject(PluginStoreContextKey, null)\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\n  let store = ctx.stores.get(fullKey) as T | undefined\n  if (store !== undefined) return store\n\n  // 2. Single-arg fallback\n  if (key === undefined) {\n    store = ctx.stores.get(nsOrKey) as T | undefined\n    if (store !== undefined) return store\n\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: 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"]}