@jini-ai/ui 0.1.0

package/dist/features/i18n/locale.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Framework-free locale-resolution logic for the i18n feature — kept apart
+ * from `context.tsx` so the priority-chain algorithm (persisted choice >
+ * system detection > fallback) is directly unit-testable without mounting
+ * a React tree.
+ *
+ * Origin: `i18n/index.tsx`'s `resolveSystemLocale`/`detectInitialLocale` in
+ * the vendored OD web tree. Genericized — see `packages/ui/source-map.md`
+ * for the full accounting of what was dropped (OD's hard-coded 19-locale
+ * list, the desktop-host OS-locale bridge, the manual-vs-auto-detected
+ * localStorage tagging).
+ */
+import type { Locale } from './types.js';
+/**
+ * Resolve the best supported locale for a list of preferred language tags
+ * (e.g. `navigator.languages`), in priority order.
+ *
+ * Match order per candidate language tag: exact case-insensitive match,
+ * then a Chinese script/region special-case (bare `zh`/regionless tags
+ * resolve to simplified vs. traditional by script/region signal — a
+ * generic BCP-47 fallback, not OD-specific), then a bare base-language
+ * match (`'en-GB'` → `'en'` when only `'en'` is supported).
+ *
+ * @param languages - preferred language tags, most-preferred first.
+ * @param supportedLocales - locales the host actually has a dictionary for.
+ * @returns the first supported locale that matches, or `null`.
+ * @complexity O(languages.length * supportedLocales.length) — both lists
+ * are small (single-digit to low tens), so the naive nested scan is not
+ * worth trading against readability here.
+ * @overallScore 100
+ */
+export declare function resolveSystemLocale(languages: readonly string[], supportedLocales: readonly Locale[]): Locale | null;
+/**
+ * Default {@link SystemLocaleDetector}: resolves the browser's preferred
+ * languages against the supplied supported-locale list. A host on a
+ * platform where `navigator.languages` doesn't reflect the real OS locale
+ * (e.g. a packaged desktop shell) supplies its own detector instead of this
+ * default — see `I18nProviderProps.detectSystemLocale`.
+ */
+export declare function defaultDetectSystemLocale(supportedLocales: readonly Locale[]): Locale | null;
+/** Host-supplied locale persistence (e.g. localStorage-backed). */
+export interface LocalePersistencePort {
+    getStoredLocale(): Locale | null;
+    setStoredLocale(locale: Locale): void;
+}
+/** Host-supplied system-locale probe. See {@link defaultDetectSystemLocale}. */
+export type SystemLocaleDetector = (supportedLocales: readonly Locale[]) => Locale | null;
+export interface DetectInitialLocaleOptions {
+    supportedLocales: readonly Locale[];
+    fallbackLocale: Locale;
+    persistence?: LocalePersistencePort | undefined;
+    detectSystemLocale?: SystemLocaleDetector | undefined;
+}
+/**
+ * Resolve the locale a provider should start in, in priority order:
+ * a persisted choice (if the host supplies persistence and it names a
+ * supported locale) > system detection > `fallbackLocale`.
+ *
+ * Origin's `detectInitialLocale` additionally tagged localStorage writes
+ * as "manual" vs. "auto-detected" so only a deliberate user pick could
+ * out-rank a freshly-read OS locale. That nuance is OD product policy, not
+ * generic mechanism — dropped here; a host that wants it implements the
+ * same rule inside its own {@link LocalePersistencePort} (e.g. only call
+ * `setStoredLocale` from an explicit "change language" action).
+ *
+ * @overallScore 100
+ */
+export declare function detectInitialLocale(options: DetectInitialLocaleOptions): Locale;
+//# sourceMappingURL=locale.d.ts.map

package/dist/features/i18n/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../../src/features/i18n/locale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,MAAM,GAAG,IAAI,CA2Bf;AAQD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAE5F;AAED,mEAAmE;AACnE,MAAM,WAAW,qBAAqB;IACpC,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,GAAG,IAAI,CAAC;AAE1F,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAChD,kBAAkB,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACvD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAY/E"}

package/dist/features/i18n/locale.js

@@ -0,0 +1,86 @@
+/**
+ * Resolve the best supported locale for a list of preferred language tags
+ * (e.g. `navigator.languages`), in priority order.
+ *
+ * Match order per candidate language tag: exact case-insensitive match,
+ * then a Chinese script/region special-case (bare `zh`/regionless tags
+ * resolve to simplified vs. traditional by script/region signal — a
+ * generic BCP-47 fallback, not OD-specific), then a bare base-language
+ * match (`'en-GB'` → `'en'` when only `'en'` is supported).
+ *
+ * @param languages - preferred language tags, most-preferred first.
+ * @param supportedLocales - locales the host actually has a dictionary for.
+ * @returns the first supported locale that matches, or `null`.
+ * @complexity O(languages.length * supportedLocales.length) — both lists
+ * are small (single-digit to low tens), so the naive nested scan is not
+ * worth trading against readability here.
+ * @overallScore 100
+ */
+export function resolveSystemLocale(languages, supportedLocales) {
+    for (const raw of languages) {
+        const normalized = raw.trim();
+        if (!normalized)
+            continue;
+        const exact = supportedLocales.find((locale) => locale.toLowerCase() === normalized.toLowerCase());
+        if (exact)
+            return exact;
+        const [language, regionOrScript] = normalized.toLowerCase().split('-');
+        if (language === 'zh') {
+            const isTraditionalScript = regionOrScript === 'hant' ||
+                regionOrScript === 'tw' ||
+                regionOrScript === 'hk' ||
+                regionOrScript === 'mo';
+            const candidate = isTraditionalScript ? 'zh-TW' : 'zh-CN';
+            if (supportedLocales.includes(candidate))
+                return candidate;
+        }
+        const baseMatch = supportedLocales.find((locale) => locale.toLowerCase().split('-')[0] === language);
+        if (baseMatch)
+            return baseMatch;
+    }
+    return null;
+}
+/** Reads `navigator.languages` (falling back to `navigator.language`). */
+function browserPreferredLanguages() {
+    if (typeof navigator === 'undefined')
+        return [];
+    return navigator.languages?.length ? navigator.languages : [navigator.language];
+}
+/**
+ * Default {@link SystemLocaleDetector}: resolves the browser's preferred
+ * languages against the supplied supported-locale list. A host on a
+ * platform where `navigator.languages` doesn't reflect the real OS locale
+ * (e.g. a packaged desktop shell) supplies its own detector instead of this
+ * default — see `I18nProviderProps.detectSystemLocale`.
+ */
+export function defaultDetectSystemLocale(supportedLocales) {
+    return resolveSystemLocale(browserPreferredLanguages(), supportedLocales);
+}
+/**
+ * Resolve the locale a provider should start in, in priority order:
+ * a persisted choice (if the host supplies persistence and it names a
+ * supported locale) > system detection > `fallbackLocale`.
+ *
+ * Origin's `detectInitialLocale` additionally tagged localStorage writes
+ * as "manual" vs. "auto-detected" so only a deliberate user pick could
+ * out-rank a freshly-read OS locale. That nuance is OD product policy, not
+ * generic mechanism — dropped here; a host that wants it implements the
+ * same rule inside its own {@link LocalePersistencePort} (e.g. only call
+ * `setStoredLocale` from an explicit "change language" action).
+ *
+ * @overallScore 100
+ */
+export function detectInitialLocale(options) {
+    const { supportedLocales, fallbackLocale, persistence, detectSystemLocale } = options;
+    if (typeof window === 'undefined')
+        return fallbackLocale;
+    const stored = persistence?.getStoredLocale() ?? null;
+    if (stored && supportedLocales.includes(stored))
+        return stored;
+    const detect = detectSystemLocale ?? defaultDetectSystemLocale;
+    const detected = detect(supportedLocales);
+    if (detected && supportedLocales.includes(detected))
+        return detected;
+    return fallbackLocale;
+}
+//# sourceMappingURL=locale.js.map

package/dist/features/i18n/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../../../src/features/i18n/locale.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAA4B,EAC5B,gBAAmC;IAEnC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,UAAU;YAAE,SAAS;QAE1B,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CACjC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,WAAW,EAAE,CAC9D,CAAC;QACF,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QAExB,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,mBAAmB,GACvB,cAAc,KAAK,MAAM;gBACzB,cAAc,KAAK,IAAI;gBACvB,cAAc,KAAK,IAAI;gBACvB,cAAc,KAAK,IAAI,CAAC;YAC1B,MAAM,SAAS,GAAG,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YAC1D,IAAI,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAC;QAC7D,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CACrC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAC5D,CAAC;QACF,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0EAA0E;AAC1E,SAAS,yBAAyB;IAChC,IAAI,OAAO,SAAS,KAAK,WAAW;QAAE,OAAO,EAAE,CAAC;IAChD,OAAO,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,gBAAmC;IAC3E,OAAO,mBAAmB,CAAC,yBAAyB,EAAE,EAAE,gBAAgB,CAAC,CAAC;AAC5E,CAAC;AAkBD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAmC;IACrE,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC;IACtF,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,cAAc,CAAC;IAEzD,MAAM,MAAM,GAAG,WAAW,EAAE,eAAe,EAAE,IAAI,IAAI,CAAC;IACtD,IAAI,MAAM,IAAI,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAE/D,MAAM,MAAM,GAAG,kBAAkB,IAAI,yBAAyB,CAAC;IAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC1C,IAAI,QAAQ,IAAI,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAErE,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/features/i18n/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Generic i18n type vocabulary.
+ *
+ * Origin (`i18n/types.ts` in the vendored OD web tree) hard-codes a single
+ * `Locale` union of 19 language tags and a `Dict` interface with ~1,400
+ * named keys — OD's actual translated product copy, not reusable content.
+ * This module keeps only the *shape* of that pattern (a locale is a plain
+ * string, a dictionary is a flat, string-keyed lookup) so a host supplies
+ * its own locale union and its own dictionary type as a generic parameter.
+ */
+/** A BCP-47-ish locale tag (e.g. `'en'`, `'zh-CN'`). Any string a host defines. */
+export type Locale = string;
+/** Interpolation values substituted into a `{name}`-style placeholder. */
+export type TranslationVars = Record<string, string | number>;
+/**
+ * Flat, string-keyed translation dictionary. Kept flat (not deeply nested)
+ * for the same reason the origin's `Dict` was: a missing key surfaces as a
+ * plain string-index miss instead of a structural type mismatch.
+ *
+ * A host narrows this via its own dictionary interface (mirroring OD's own
+ * `Dict`) and passes `Record<Locale, ItsDict>` to {@link I18nProvider}.
+ */
+export interface TranslationDict {
+    [key: string]: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/features/i18n/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/i18n/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mFAAmF;AACnF,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B,0EAA0E;AAC1E,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB"}

package/dist/features/i18n/types.js

@@ -0,0 +1,12 @@
+/**
+ * Generic i18n type vocabulary.
+ *
+ * Origin (`i18n/types.ts` in the vendored OD web tree) hard-codes a single
+ * `Locale` union of 19 language tags and a `Dict` interface with ~1,400
+ * named keys — OD's actual translated product copy, not reusable content.
+ * This module keeps only the *shape* of that pattern (a locale is a plain
+ * string, a dictionary is a flat, string-keyed lookup) so a host supplies
+ * its own locale union and its own dictionary type as a generic parameter.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/i18n/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/i18n/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/features/iframe-pool/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_MAX_MOUNTED_IFRAMES = 5;
+//# sourceMappingURL=constants.d.ts.map

package/dist/features/iframe-pool/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/features/iframe-pool/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,IAAI,CAAC"}

package/dist/features/iframe-pool/constants.js

@@ -0,0 +1,2 @@
+export const DEFAULT_MAX_MOUNTED_IFRAMES = 5;
+//# sourceMappingURL=constants.js.map

package/dist/features/iframe-pool/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/features/iframe-pool/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC"}

package/dist/features/iframe-pool/index.d.ts

@@ -0,0 +1,9 @@
+export type { IframeKeepAlivePoolEntry, IframeKeepAlivePoolEvictOptions, IframeKeepAlivePoolValue, IframeKeepAlivePoolConfig, } from './types.js';
+export { DEFAULT_MAX_MOUNTED_IFRAMES } from './constants.js';
+export { selectLruEvictions, selectMatchingEvictions } from './rules.js';
+export { IframeKeepAliveContext } from './react/pool-context.js';
+export { useIframeKeepAlivePool } from './react/hooks/useIframeKeepAlivePool.js';
+export { IframeKeepAliveProvider } from './react/components/IframeKeepAliveProvider.js';
+export { PooledIframe } from './react/components/PooledIframe.js';
+export type { PooledIframeProps } from './react/dom-sync.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/iframe-pool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/iframe-pool/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,wBAAwB,EACxB,+BAA+B,EAC/B,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/features/iframe-pool/index.js

@@ -0,0 +1,7 @@
+export { DEFAULT_MAX_MOUNTED_IFRAMES } from './constants.js';
+export { selectLruEvictions, selectMatchingEvictions } from './rules.js';
+export { IframeKeepAliveContext } from './react/pool-context.js';
+export { useIframeKeepAlivePool } from './react/hooks/useIframeKeepAlivePool.js';
+export { IframeKeepAliveProvider } from './react/components/IframeKeepAliveProvider.js';
+export { PooledIframe } from './react/components/PooledIframe.js';
+//# sourceMappingURL=index.js.map

package/dist/features/iframe-pool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/iframe-pool/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/features/iframe-pool/react/components/IframeKeepAliveProvider.d.ts

@@ -0,0 +1,16 @@
+import { type ReactNode } from 'react';
+interface IframeKeepAliveProviderProps {
+    children: ReactNode;
+    /** Maximum iframes kept mounted (active + parked) at once. Defaults to `DEFAULT_MAX_MOUNTED_IFRAMES`. */
+    maxMounted?: number | undefined;
+}
+/**
+ * Caps how many iframes stay mounted at once: attached iframes go live under
+ * their host element; released ones are parked off-DOM (hidden, inert)
+ * instead of destroyed, so revisiting the same key skips a reload; least-
+ * recently-used parked entries are evicted once the pool exceeds
+ * `maxMounted`. Active entries are never evicted.
+ */
+export declare function IframeKeepAliveProvider({ children, maxMounted, }: IframeKeepAliveProviderProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=IframeKeepAliveProvider.d.ts.map

package/dist/features/iframe-pool/react/components/IframeKeepAliveProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IframeKeepAliveProvider.d.ts","sourceRoot":"","sources":["../../../../../src/features/iframe-pool/react/components/IframeKeepAliveProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAO7E,UAAU,4BAA4B;IACpC,QAAQ,EAAE,SAAS,CAAC;IACpB,yGAAyG;IACzG,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,UAAwC,GACzC,EAAE,4BAA4B,+BA8E9B"}

package/dist/features/iframe-pool/react/components/IframeKeepAliveProvider.js

@@ -0,0 +1,85 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { DEFAULT_MAX_MOUNTED_IFRAMES } from '../../constants.js';
+import { selectLruEvictions, selectMatchingEvictions } from '../../rules.js';
+import { parkIframeElement, unparkIframeElement } from '../dom-sync.js';
+import { IframeKeepAliveContext } from '../pool-context.js';
+/**
+ * Caps how many iframes stay mounted at once: attached iframes go live under
+ * their host element; released ones are parked off-DOM (hidden, inert)
+ * instead of destroyed, so revisiting the same key skips a reload; least-
+ * recently-used parked entries are evicted once the pool exceeds
+ * `maxMounted`. Active entries are never evicted.
+ */
+export function IframeKeepAliveProvider({ children, maxMounted = DEFAULT_MAX_MOUNTED_IFRAMES, }) {
+    const parkedHostRef = useRef(null);
+    const entriesRef = useRef(new Map());
+    const activeKeysRef = useRef(new Set());
+    const [poolRevision, bumpPoolRevision] = useState(0);
+    const removeEntry = (key) => {
+        const entry = entriesRef.current.get(key);
+        if (!entry)
+            return false;
+        const wasActive = activeKeysRef.current.has(key);
+        entry.element.remove();
+        entriesRef.current.delete(key);
+        activeKeysRef.current.delete(key);
+        return wasActive;
+    };
+    const enforceLimit = () => {
+        const entries = Array.from(entriesRef.current.values());
+        const evictions = selectLruEvictions(entries, activeKeysRef.current, maxMounted);
+        for (const key of evictions)
+            removeEntry(key);
+    };
+    const pool = useMemo(() => ({
+        attach(key, host, create) {
+            let entry = entriesRef.current.get(key);
+            if (!entry) {
+                entry = { key, element: create(), lastUsedAt: Date.now() };
+                entriesRef.current.set(key, entry);
+            }
+            else if (!activeKeysRef.current.has(key)) {
+                // Reattaching a parked entry — undo the hidden/inert markers
+                // `release()` set, or the reused iframe would stay invisible.
+                unparkIframeElement(entry.element);
+            }
+            entry.lastUsedAt = Date.now();
+            activeKeysRef.current.add(key);
+            host.appendChild(entry.element);
+            return entry.element;
+        },
+        release(key) {
+            const entry = entriesRef.current.get(key);
+            activeKeysRef.current.delete(key);
+            if (entry) {
+                // `parkedHostRef` is populated by the time any consumer can call
+                // `release` — it attaches to the same unconditionally-rendered `<div>`
+                // during the commit that mounts this provider, before any consumer
+                // downstream could have received the pool value used to call this.
+                parkIframeElement(entry.element);
+                parkedHostRef.current.appendChild(entry.element);
+            }
+            enforceLimit();
+        },
+        evict(key) {
+            if (removeEntry(key))
+                bumpPoolRevision((value) => value + 1);
+        },
+        evictMatching(predicate, options) {
+            const entries = Array.from(entriesRef.current.values());
+            const keys = selectMatchingEvictions(entries, activeKeysRef.current, predicate, options?.includeActive ?? false);
+            let removedActive = false;
+            for (const key of keys)
+                removedActive = removeEntry(key) || removedActive;
+            if (removedActive)
+                bumpPoolRevision((value) => value + 1);
+        },
+    }), [maxMounted, poolRevision]);
+    useEffect(() => () => {
+        for (const key of Array.from(entriesRef.current.keys()))
+            removeEntry(key);
+    }, []);
+    return (_jsxs(IframeKeepAliveContext.Provider, { value: pool, children: [children, _jsx("div", { ref: parkedHostRef, className: "iframe-keep-alive-pool", "aria-hidden": "true" })] }));
+}
+//# sourceMappingURL=IframeKeepAliveProvider.js.map

package/dist/features/iframe-pool/react/components/IframeKeepAliveProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IframeKeepAliveProvider.js","sourceRoot":"","sources":["../../../../../src/features/iframe-pool/react/components/IframeKeepAliveProvider.tsx"],"names":[],"mappings":"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"}

package/dist/features/iframe-pool/react/components/PooledIframe.d.ts

@@ -0,0 +1,12 @@
+/**
+ * An `<iframe>` whose element is kept alive in the nearest
+ * `IframeKeepAlivePoolProvider` (or a local single-entry fallback pool if
+ * none is mounted) across unmount/remount under the same `cacheKey`,
+ * instead of reloading. Renders a plain `<iframe>` during SSR, since the
+ * pool is a client-only concept.
+ */
+export declare const PooledIframe: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").IframeHTMLAttributes<HTMLIFrameElement>, HTMLIFrameElement>, "ref"> & {
+    cacheKey: string;
+    src: string;
+} & import("react").RefAttributes<HTMLIFrameElement>>;
+//# sourceMappingURL=PooledIframe.d.ts.map

package/dist/features/iframe-pool/react/components/PooledIframe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PooledIframe.d.ts","sourceRoot":"","sources":["../../../../../src/features/iframe-pool/react/components/PooledIframe.tsx"],"names":[],"mappings":"AAiBA;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;;qDAevB,CAAC"}

package/dist/features/iframe-pool/react/components/PooledIframe.js

@@ -0,0 +1,53 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useLayoutEffect, useRef, useSyncExternalStore, } from 'react';
+import { useIframeKeepAlivePool } from '../hooks/useIframeKeepAlivePool.js';
+import { setForwardedRef, syncIframeProps } from '../dom-sync.js';
+const subscribeToNoopStore = () => () => { };
+const getClientSnapshot = () => false;
+const getServerSnapshot = () => true;
+function useIsServerRender() {
+    return useSyncExternalStore(subscribeToNoopStore, getClientSnapshot, getServerSnapshot);
+}
+/**
+ * An `<iframe>` whose element is kept alive in the nearest
+ * `IframeKeepAlivePoolProvider` (or a local single-entry fallback pool if
+ * none is mounted) across unmount/remount under the same `cacheKey`,
+ * instead of reloading. Renders a plain `<iframe>` during SSR, since the
+ * pool is a client-only concept.
+ */
+export const PooledIframe = forwardRef(function PooledIframe({ cacheKey, src, ...props }, forwardedRef) {
+    const isServerRender = useIsServerRender();
+    if (isServerRender)
+        return _jsx("iframe", { ...props, src: src });
+    return (_jsx(ClientPooledIframe, { ref: forwardedRef, cacheKey: cacheKey, src: src, ...props }));
+});
+const ClientPooledIframe = forwardRef(function ClientPooledIframe({ cacheKey, src, ...props }, forwardedRef) {
+    const pool = useIframeKeepAlivePool();
+    const hostRef = useRef(null);
+    const iframeRef = useRef(null);
+    const propsRef = useRef({ cacheKey, src, ...props });
+    const appliedAttributesRef = useRef(new Set());
+    const appliedStyleKeysRef = useRef(new Set());
+    propsRef.current = { cacheKey, src, ...props };
+    useLayoutEffect(() => {
+        // `hostRef` attaches to the unconditionally-rendered `<span>` below during
+        // the same commit, before any layout effect runs — it's always set here.
+        const frame = pool.attach(cacheKey, hostRef.current, () => document.createElement('iframe'));
+        iframeRef.current = frame;
+        return () => {
+            setForwardedRef(forwardedRef, null);
+            iframeRef.current = null;
+            pool.release(cacheKey);
+        };
+    }, [cacheKey, pool, forwardedRef]);
+    useLayoutEffect(() => {
+        // The effect above always runs first (declared earlier in the same
+        // component, same commit) and sets `iframeRef.current` before this one
+        // ever runs, so it's always populated here.
+        const frame = iframeRef.current;
+        syncIframeProps(frame, propsRef.current, appliedAttributesRef.current, appliedStyleKeysRef.current);
+        setForwardedRef(forwardedRef, frame);
+    });
+    return _jsx("span", { ref: hostRef, className: "pooled-iframe-host" });
+});
+//# sourceMappingURL=PooledIframe.js.map

package/dist/features/iframe-pool/react/components/PooledIframe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PooledIframe.js","sourceRoot":"","sources":["../../../../../src/features/iframe-pool/react/components/PooledIframe.tsx"],"names":[],"mappings":"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"}

package/dist/features/iframe-pool/react/dom-sync.d.ts

@@ -0,0 +1,15 @@
+import type { ComponentPropsWithoutRef, CSSProperties, Ref } from 'react';
+export type PooledIframeProps = ComponentPropsWithoutRef<'iframe'> & {
+    cacheKey: string;
+    src: string;
+};
+export declare function setForwardedRef(ref: Ref<HTMLIFrameElement> | undefined, value: HTMLIFrameElement | null): void;
+export declare function propNameToAttributeName(name: string): string;
+export declare function setAttribute(frame: HTMLIFrameElement, name: string, value: unknown): void;
+export declare function syncStyle(frame: HTMLIFrameElement, style: CSSProperties | undefined, appliedStyleKeys: Set<string>): void;
+export declare function syncIframeProps(frame: HTMLIFrameElement, props: PooledIframeProps, appliedAttributes: Set<string>, appliedStyleKeys: Set<string>): void;
+/** Parks a released iframe off-DOM instead of destroying it: strips test/interaction hooks and hides it from a11y trees and tab order. */
+export declare function parkIframeElement(frame: HTMLIFrameElement): void;
+/** Reverses `parkIframeElement` when a parked entry is reattached, so a reused iframe isn't left permanently hidden/inert. */
+export declare function unparkIframeElement(frame: HTMLIFrameElement): void;
+//# sourceMappingURL=dom-sync.d.ts.map

package/dist/features/iframe-pool/react/dom-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-sync.d.ts","sourceRoot":"","sources":["../../../../src/features/iframe-pool/react/dom-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,aAAa,EAAE,GAAG,EAAkB,MAAM,OAAO,CAAC;AAE1F,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,QAAQ,CAAC,GAAG;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,QAMvG;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,QAWlF;AAuBD,wBAAgB,SAAS,CACvB,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,QAsB9B;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,iBAAiB,EACxB,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC9B,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,QA8B9B;AAED,0IAA0I;AAC1I,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,QAMzD;AAED,8HAA8H;AAC9H,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,QAI3D"}

package/dist/features/iframe-pool/react/dom-sync.js

@@ -0,0 +1,119 @@
+export function setForwardedRef(ref, value) {
+    if (typeof ref === 'function') {
+        ref(value);
+    }
+    else if (ref) {
+        ref.current = value;
+    }
+}
+export function propNameToAttributeName(name) {
+    if (name === 'className')
+        return 'class';
+    if (name === 'htmlFor')
+        return 'for';
+    if (name === 'srcDoc')
+        return 'srcdoc';
+    if (name === 'tabIndex')
+        return 'tabindex';
+    if (name.startsWith('data-') || name.startsWith('aria-'))
+        return name;
+    return name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`).toLowerCase();
+}
+export function setAttribute(frame, name, value) {
+    if (value == null || value === false) {
+        frame.removeAttribute(name);
+        return;
+    }
+    if (value === true) {
+        frame.setAttribute(name, '');
+        return;
+    }
+    const next = String(value);
+    if (frame.getAttribute(name) !== next)
+        frame.setAttribute(name, next);
+}
+// CSS properties whose numeric values are dimensionless (no implicit "px").
+// Matches React's own inline-style patcher's unitless-number list — needed
+// here because, unlike a normal React-rendered element, this frame's style
+// is synced manually (imperative DOM writes), so React's own auto-unit
+// behavior for e.g. `style={{ width: 10 }}` never runs for it.
+const UNITLESS_NUMBER_PROPERTIES = new Set([
+    'animation-iteration-count', 'aspect-ratio', 'border-image-outset', 'border-image-slice',
+    'border-image-width', 'column-count', 'flex', 'flex-grow', 'flex-shrink', 'font-weight',
+    'grid-area', 'grid-column', 'grid-column-end', 'grid-column-start', 'grid-row', 'grid-row-end',
+    'grid-row-start', 'line-height', 'opacity', 'order', 'orphans', 'tab-size', 'widows', 'z-index',
+    'zoom', 'fill-opacity', 'flood-opacity', 'stop-opacity', 'stroke-dasharray',
+    'stroke-dashoffset', 'stroke-miterlimit', 'stroke-opacity', 'stroke-width',
+]);
+function styleValueToString(cssKey, value) {
+    if (typeof value === 'number' && !UNITLESS_NUMBER_PROPERTIES.has(cssKey)) {
+        return `${value}px`;
+    }
+    return String(value);
+}
+export function syncStyle(frame, style, appliedStyleKeys) {
+    if (!style) {
+        frame.removeAttribute('style');
+        appliedStyleKeys.clear();
+        return;
+    }
+    for (const key of Array.from(appliedStyleKeys)) {
+        if (!(key in style)) {
+            frame.style.setProperty(key, '');
+            appliedStyleKeys.delete(key);
+        }
+    }
+    for (const [key, value] of Object.entries(style)) {
+        const cssKey = key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+        appliedStyleKeys.add(cssKey);
+        if (value == null) {
+            frame.style.setProperty(cssKey, '');
+        }
+        else {
+            frame.style.setProperty(cssKey, styleValueToString(cssKey, value));
+        }
+    }
+}
+export function syncIframeProps(frame, props, appliedAttributes, appliedStyleKeys) {
+    const nextAttributes = new Set();
+    for (const [name, value] of Object.entries(props)) {
+        if (name === 'cacheKey'
+            || name === 'src'
+            || name === 'style'
+            || name === 'children'
+            || name === 'dangerouslySetInnerHTML'
+            || name.startsWith('on')) {
+            continue;
+        }
+        const attributeName = propNameToAttributeName(name);
+        nextAttributes.add(attributeName);
+        setAttribute(frame, attributeName, value);
+    }
+    for (const previous of Array.from(appliedAttributes)) {
+        if (!nextAttributes.has(previous))
+            frame.removeAttribute(previous);
+    }
+    appliedAttributes.clear();
+    for (const attribute of nextAttributes)
+        appliedAttributes.add(attribute);
+    syncStyle(frame, props.style, appliedStyleKeys);
+    frame.onload = props.onLoad
+        ? (event) => props.onLoad?.(event)
+        : null;
+    setAttribute(frame, 'src', props.src);
+}
+/** Parks a released iframe off-DOM instead of destroying it: strips test/interaction hooks and hides it from a11y trees and tab order. */
+export function parkIframeElement(frame) {
+    frame.onload = null;
+    frame.removeAttribute('data-testid');
+    frame.setAttribute('data-pool-active', 'false');
+    frame.setAttribute('aria-hidden', 'true');
+    frame.setAttribute('tabindex', '-1');
+}
+/** Reverses `parkIframeElement` when a parked entry is reattached, so a reused iframe isn't left permanently hidden/inert. */
+export function unparkIframeElement(frame) {
+    frame.removeAttribute('data-pool-active');
+    frame.removeAttribute('aria-hidden');
+    frame.removeAttribute('tabindex');
+}
+//# sourceMappingURL=dom-sync.js.map

package/dist/features/iframe-pool/react/dom-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-sync.js","sourceRoot":"","sources":["../../../../src/features/iframe-pool/react/dom-sync.ts"],"names":[],"mappings":"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"}

package/dist/features/iframe-pool/react/hooks/useIframeKeepAlivePool.d.ts

@@ -0,0 +1,10 @@
+import type { IframeKeepAlivePoolValue } from '../../types.js';
+/**
+ * Reads the nearest `IframeKeepAlivePoolProvider`'s pool. If none is
+ * mounted, returns a self-contained single-entry fallback pool so a
+ * `PooledIframe` still works standalone — it just gets no LRU/keep-alive
+ * benefit (only ever holds the entries its own caller attaches, and never
+ * enforces a mounted-count limit).
+ */
+export declare function useIframeKeepAlivePool(): IframeKeepAlivePoolValue;
+//# sourceMappingURL=useIframeKeepAlivePool.d.ts.map

package/dist/features/iframe-pool/react/hooks/useIframeKeepAlivePool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIframeKeepAlivePool.d.ts","sourceRoot":"","sources":["../../../../../src/features/iframe-pool/react/hooks/useIframeKeepAlivePool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA4B,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAIzF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,wBAAwB,CAoDjE"}