@jini-ai/ui 0.1.0

package/dist/features/version-manager/ports.d.ts

@@ -0,0 +1,53 @@
+import type { VersionManagerFileRef, VersionRecord, VersionRestoreResult } from './types.js';
+/**
+ * The transport seam this feature needs from a host. All four OD-specific
+ * coupling points the classification found (the version-list fetch, the
+ * per-version content fetch, the restore call, and the deck/base-href
+ * preview-option resolution) land here as one interface.
+ */
+export interface VersionManagerPort<TVersion extends VersionRecord = VersionRecord> {
+    /** Fetches the full version list for `fileRef`, newest-or-oldest-first
+     *  (this feature sorts it either way via `rules.ts`'s
+     *  `sortVersionsDescending`). Returns `null` on failure — the hook turns
+     *  that into a load-error message it displays, matching the source. */
+    listVersions(fileRef: VersionManagerFileRef): Promise<TVersion[] | null>;
+    /** Fetches one version's full content. Returns `null` if the version's
+     *  content could not be loaded. */
+    fetchVersionContent(fileRef: VersionManagerFileRef, versionId: string): Promise<string | null>;
+    /** Restores `version` as the file's current content. Returns `null` on
+     *  outright failure; a non-null result may still carry a `warning` for a
+     *  restore that otherwise succeeded (see `VersionRestoreResult`). */
+    restoreVersion(fileRef: VersionManagerFileRef, version: TVersion): Promise<VersionRestoreResult<TVersion> | null>;
+    /**
+     * Turns raw version content into whatever a host wants to mount in the
+     * preview `srcDoc`. This is deliberately NOT a sandboxed-iframe-builder
+     * port — the classification found the source's own `buildSrcdoc`/
+     * `fileVersionPreviewOptions` (deck-sniffing, base-href resolution) is
+     * shared infrastructure the eventual `@jini-ai/renderers-react` sandbox
+     * core should own, which does not exist yet (see
+     * `packages/ui/source-map.md`'s `html-viewer` section). A host with a
+     * real sandbox core implements this by delegating to it; a host without
+     * one can just return `content` unchanged for a plain, unsandboxed
+     * preview. Either way this feature stays decoupled from that
+     * not-yet-built core.
+     */
+    resolvePreviewDocument(fileRef: VersionManagerFileRef, content: string): string;
+    /** Opens a version's content in a new tab/window. Optional — a host that
+     *  doesn't support this can omit it; the "open in new tab" action is
+     *  hidden when absent. */
+    openPreviewInNewTab?(fileRef: VersionManagerFileRef, content: string, title: string): void;
+}
+/** The one browser API this feature needs directly (copying the
+ *  generating-prompt text) — same minimal shape as
+ *  `features/viewer-shell/`'s `ViewerClipboardPort`, kept as an
+ *  independent type so this feature has no compile-time dependency on
+ *  viewer-shell's `ports.ts` (only its React-layer `useCopyToClipboard`
+ *  hook/dependency-binding, which structurally satisfies this interface). */
+export interface VersionManagerClipboardPort {
+    copyText(text: string): Promise<boolean>;
+}
+export interface VersionManagerDependencies<TVersion extends VersionRecord = VersionRecord> {
+    versions: VersionManagerPort<TVersion>;
+    clipboard: VersionManagerClipboardPort;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/features/version-manager/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/features/version-manager/ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE7F;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa;IAChF;;;2EAGuE;IACvE,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;IAEzE;uCACmC;IACnC,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE/F;;yEAEqE;IACrE,cAAc,CACZ,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IAElD;;;;;;;;;;;;OAYG;IACH,sBAAsB,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhF;;8BAE0B;IAC1B,mBAAmB,CAAC,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5F;AAED;;;;;6EAK6E;AAC7E,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,0BAA0B,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa;IACxF,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACvC,SAAS,EAAE,2BAA2B,CAAC;CACxC"}

package/dist/features/version-manager/ports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/features/version-manager/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../src/features/version-manager/ports.ts"],"names":[],"mappings":""}

package/dist/features/version-manager/react/components/VersionManagerModal.d.ts

@@ -0,0 +1,28 @@
+import { type ViewportPreset } from '../../../viewer-shell/index.js';
+import type { VersionManagerDependencies } from '../../ports.js';
+import type { VersionManagerFileRef, VersionRecord } from '../../types.js';
+import { useVersionManager } from '../hooks/useVersionManager.js';
+export interface VersionManagerModalProps<TVersion extends VersionRecord> {
+    fileRef: VersionManagerFileRef;
+    /** The file's current content, seeding the cache for its `current`
+     *  version so it renders instantly with no round-trip. */
+    currentContent: string | null;
+    onClose: () => void;
+    onRestored: (content: string, version: TVersion) => Promise<void> | void;
+    /** Defaults to the package's in-memory fake port + real browser
+     *  clipboard — a real host supplies its own transport. */
+    dependencies?: VersionManagerDependencies<TVersion>;
+    viewportPresets?: ViewportPreset[];
+    /** Custom hook override for dependency injection / testing. */
+    useVersionManager?: typeof useVersionManager;
+}
+/**
+ * The generic slice of the source's `FileVersionManagerModal`: a list +
+ * cached-preview + restore + search modal shell. See
+ * `packages/ui/source-map.md`'s `html-viewer` classification section for
+ * what was dropped (deploy/analytics calls — there were none; the actual
+ * fetch/restore/preview-resolution calls became the injected
+ * `VersionManagerPort`).
+ */
+export declare function VersionManagerModal<TVersion extends VersionRecord>({ fileRef, currentContent, onClose, onRestored, dependencies, viewportPresets, useVersionManager: useVersionManagerHook, }: VersionManagerModalProps<TVersion>): import("react").ReactPortal;
+//# sourceMappingURL=VersionManagerModal.d.ts.map

package/dist/features/version-manager/react/components/VersionManagerModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionManagerModal.d.ts","sourceRoot":"","sources":["../../../../../src/features/version-manager/react/components/VersionManagerModal.tsx"],"names":[],"mappings":"AAGA,OAAO,EAA2C,KAAK,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAG9G,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAMlE,MAAM,WAAW,wBAAwB,CAAC,QAAQ,SAAS,aAAa;IACtE,OAAO,EAAE,qBAAqB,CAAC;IAC/B;8DAC0D;IAC1D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACzE;8DAC0D;IAC1D,YAAY,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IACpD,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,OAAO,iBAAiB,CAAC;CAC9C;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,aAAa,EAAE,EAClE,OAAO,EACP,cAAc,EACd,OAAO,EACP,UAAU,EACV,YAAmG,EACnG,eAAe,EACf,iBAAiB,EAAE,qBAAyC,GAC7D,EAAE,wBAAwB,CAAC,QAAQ,CAAC,+BAyKpC"}

package/dist/features/version-manager/react/components/VersionManagerModal.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createPortal } from 'react-dom';
+import { useCallback, useEffect, useRef } from 'react';
+import { useI18n } from '../../../i18n/index.js';
+import { useCopyToClipboard, ViewportToggleGroup } from '../../../viewer-shell/index.js';
+import { defaultVersionManagerDependencies } from '../../dependencies.js';
+import { formatVersionDateTime, restoredFromVersion, versionSourceClassName, versionSourceLabel } from '../../rules.js';
+import { useVersionManager } from '../hooks/useVersionManager.js';
+import { VersionSidebar } from './VersionSidebar.js';
+import { VersionPromptPopover } from './VersionPromptPopover.js';
+import { VersionRestoreControl } from './VersionRestoreControl.js';
+import { VersionPreviewFrame } from './VersionPreviewFrame.js';
+/**
+ * The generic slice of the source's `FileVersionManagerModal`: a list +
+ * cached-preview + restore + search modal shell. See
+ * `packages/ui/source-map.md`'s `html-viewer` classification section for
+ * what was dropped (deploy/analytics calls — there were none; the actual
+ * fetch/restore/preview-resolution calls became the injected
+ * `VersionManagerPort`).
+ */
+export function VersionManagerModal({ fileRef, currentContent, onClose, onRestored, dependencies = defaultVersionManagerDependencies, viewportPresets, useVersionManager: useVersionManagerHook = useVersionManager, }) {
+    const { t, locale } = useI18n();
+    const controller = useVersionManagerHook(dependencies, {
+        fileRef,
+        currentContent,
+        onRestored,
+        onRestoredCleanly: onClose,
+        ...(viewportPresets ? { viewportPresets } : {}),
+    });
+    const { copied, copy } = useCopyToClipboard(dependencies.clipboard);
+    const { versions, visibleVersions, versionById, selectedVersion, search, setSearch, showSearch, loading, loadingContent, error, previewDocument, frameReady, markFrameLoaded, restoring, restoreDisabled, restore, openInNewTab, viewportPresets: presets, viewport, setViewport, selectVersion, prefetchVersion, } = controller;
+    const versionCountLabel = versions.length === 1 ? t('1 version') : t('{count} versions', { count: versions.length });
+    const selectedPrompt = selectedVersion?.prompt?.trim() ?? '';
+    const selectedDate = selectedVersion ? formatVersionDateTime(selectedVersion.createdAt, locale) : fileRef.name;
+    const selectedRestoredFrom = selectedVersion ? restoredFromVersion(selectedVersion, versionById) : null;
+    // Layered Escape handling: close the modal only when neither popover is
+    // consuming the keystroke — each popover owns its own Escape dismissal
+    // via `useDismissOnOutsideOrEscape`, so this only needs to know whether
+    // to let Escape reach the modal itself. Simplified from the source's
+    // single-listener if/else priority chain to two independently-scoped
+    // listeners plus this modal-level one; see source-map.md for why this is
+    // a disclosed, behavior-preserving-in-practice simplification.
+    //
+    // `promptOpenRef` is how the modal knows "to let Escape reach the modal
+    // itself": `VersionPromptPopover` is mounted once (unconditionally) and
+    // registers its own document `keydown` listener only while it holds
+    // itself open, so this modal-level listener — added once at mount,
+    // always earlier in the document's listener order than any popover
+    // listener it later attaches on open — reads the ref synchronously
+    // before the popover's own handler has run and closes itself. A plain
+    // `event.stopPropagation()` in the popover wouldn't help here since its
+    // listener always fires *after* this one for that reason.
+    const promptOpenRef = useRef(false);
+    const handleEscape = useCallback((event) => {
+        if (event.key === 'Escape' && !promptOpenRef.current)
+            onClose();
+    }, [onClose]);
+    useEffect(() => {
+        document.addEventListener('keydown', handleEscape);
+        return () => document.removeEventListener('keydown', handleEscape);
+    }, [handleEscape]);
+    return createPortal(_jsx("div", { className: "jini-modal-backdrop jini-version-modal-backdrop", role: "presentation", onMouseDown: (event) => {
+            if (event.target === event.currentTarget)
+                onClose();
+        }, children: _jsxs("div", { className: "jini-version-modal", role: "dialog", "aria-modal": "true", "aria-label": t('Version history'), children: [_jsx(VersionSidebar, { countLabel: versionCountLabel, search: search, onSearchChange: setSearch, showSearch: showSearch, loading: loading, versions: versions, visibleVersions: visibleVersions, selectedVersionId: selectedVersion?.id ?? null, onSelect: selectVersion, onPrefetch: prefetchVersion, formatDate: (version) => formatVersionDateTime(version.createdAt, locale), sourceLabel: (version) => t(versionSourceLabel(version.source)), sourceClassName: (version) => versionSourceClassName(version.source), restoredFrom: (version) => restoredFromVersion(version, versionById) }), _jsxs("div", { className: "jini-version-main", children: [_jsxs("header", { className: "jini-version-head", children: [_jsx("div", { className: "jini-version-meta", children: _jsxs("div", { className: "jini-version-meta-row", children: [selectedVersion?.current ? (_jsx("span", { className: "jini-version-current-badge", children: t('Current') })) : null, selectedVersion ? (_jsx("span", { className: `jini-version-source-badge ${versionSourceClassName(selectedVersion.source)}`, children: t(versionSourceLabel(selectedVersion.source)) })) : null, _jsx("span", { className: "jini-version-selected-date", children: selectedDate }), selectedRestoredFrom ? (_jsx("span", { className: "jini-version-restored-from", children: t('Restored from v{version}', { version: selectedRestoredFrom.version }) })) : null, _jsx(VersionPromptPopover, { prompt: selectedPrompt, disabled: !selectedVersion, copied: copied, onCopy: (text) => void copy(text), onOpenChange: (open) => {
+                                                    promptOpenRef.current = open;
+                                                } })] }) }), _jsxs("div", { className: "jini-version-actions", children: [selectedVersion && !selectedVersion.current ? (_jsx(VersionRestoreControl, { disabled: restoreDisabled, restoring: restoring, onRestore: () => void restore() })) : null, _jsx(ViewportToggleGroup, { presets: presets, viewport: viewport, onViewport: setViewport, ariaLabel: t('Preview viewport') }), openInNewTab ? (_jsx("button", { type: "button", className: "jini-viewer-action jini-viewer-action-icon", "aria-label": t('Open in new tab'), title: t('Open in new tab'), disabled: loadingContent, onClick: openInNewTab, children: t('Open') })) : null, _jsx("button", { type: "button", className: "jini-viewer-action jini-viewer-action-icon", "aria-label": t('Close'), title: t('Close'), onClick: onClose, children: t('Close') })] })] }), _jsx(VersionPreviewFrame, { previewDocument: previewDocument, frameReady: frameReady, onFrameLoad: () => markFrameLoaded(previewDocument), viewport: viewport, viewportPresets: presets, title: selectedVersion ? `${fileRef.name} · v${selectedVersion.version}` : fileRef.name, error: error, loading: loading, loadingContent: loadingContent })] })] }) }), document.body);
+}
+//# sourceMappingURL=VersionManagerModal.js.map

package/dist/features/version-manager/react/components/VersionManagerModal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionManagerModal.js","sourceRoot":"","sources":["../../../../../src/features/version-manager/react/components/VersionManagerModal.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAuB,MAAM,gCAAgC,CAAC;AAC9G,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGxH,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAiB/D;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAiC,EAClE,OAAO,EACP,cAAc,EACd,OAAO,EACP,UAAU,EACV,YAAY,GAAG,iCAAoF,EACnG,eAAe,EACf,iBAAiB,EAAE,qBAAqB,GAAG,iBAAiB,GACzB;IACnC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;IAChC,MAAM,UAAU,GAAG,qBAAqB,CAAC,YAAY,EAAE;QACrD,OAAO;QACP,cAAc;QACd,UAAU;QACV,iBAAiB,EAAE,OAAO;QAC1B,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,CAAC;IACH,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAEpE,MAAM,EACJ,QAAQ,EACR,eAAe,EACf,WAAW,EACX,eAAe,EACf,MAAM,EACN,SAAS,EACT,UAAU,EACV,OAAO,EACP,cAAc,EACd,KAAK,EACL,eAAe,EACf,UAAU,EACV,eAAe,EACf,SAAS,EACT,eAAe,EACf,OAAO,EACP,YAAY,EACZ,eAAe,EAAE,OAAO,EACxB,QAAQ,EACR,WAAW,EACX,aAAa,EACb,eAAe,GAChB,GAAG,UAAU,CAAC;IAEf,MAAM,iBAAiB,GACrB,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7F,MAAM,cAAc,GAAG,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC7D,MAAM,YAAY,GAAG,eAAe,CAAC,CAAC,CAAC,qBAAqB,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/G,MAAM,oBAAoB,GAAG,eAAe,CAAC,CAAC,CAAC,mBAAmB,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAExG,wEAAwE;IACxE,uEAAuE;IACvE,wEAAwE;IACxE,qEAAqE;IACrE,qEAAqE;IACrE,yEAAyE;IACzE,+DAA+D;IAC/D,EAAE;IACF,wEAAwE;IACxE,wEAAwE;IACxE,oEAAoE;IACpE,mEAAmE;IACnE,mEAAmE;IACnE,mEAAmE;IACnE,sEAAsE;IACtE,wEAAwE;IACxE,0DAA0D;IAC1D,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,KAAoB,EAAE,EAAE;QACvB,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;IAClE,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IACF,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACnD,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACrE,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,OAAO,YAAY,CACjB,cACE,SAAS,EAAC,iDAAiD,EAC3D,IAAI,EAAC,cAAc,EACnB,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE;YACrB,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,aAAa;gBAAE,OAAO,EAAE,CAAC;QACtD,CAAC,YAED,eAAK,SAAS,EAAC,oBAAoB,EAAC,IAAI,EAAC,QAAQ,gBAAY,MAAM,gBAAa,CAAC,CAAC,iBAAiB,CAAC,aAClG,KAAC,cAAc,IACb,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,SAAS,EACzB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,eAAe,EAAE,eAAe,EAChC,iBAAiB,EAAE,eAAe,EAAE,EAAE,IAAI,IAAI,EAC9C,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,eAAe,EAC3B,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,qBAAqB,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,EACzE,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAC/D,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,MAAM,CAAC,EACpE,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,GACpE,EACF,eAAK,SAAS,EAAC,mBAAmB,aAChC,kBAAQ,SAAS,EAAC,mBAAmB,aACnC,cAAK,SAAS,EAAC,mBAAmB,YAChC,eAAK,SAAS,EAAC,uBAAuB,aACnC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,CAC1B,eAAM,SAAS,EAAC,4BAA4B,YAAE,CAAC,CAAC,SAAS,CAAC,GAAQ,CACnE,CAAC,CAAC,CAAC,IAAI,EACP,eAAe,CAAC,CAAC,CAAC,CACjB,eAAM,SAAS,EAAE,6BAA6B,sBAAsB,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,YAC3F,CAAC,CAAC,kBAAkB,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,GACzC,CACR,CAAC,CAAC,CAAC,IAAI,EACR,eAAM,SAAS,EAAC,4BAA4B,YAAE,YAAY,GAAQ,EACjE,oBAAoB,CAAC,CAAC,CAAC,CACtB,eAAM,SAAS,EAAC,4BAA4B,YACzC,CAAC,CAAC,0BAA0B,EAAE,EAAE,OAAO,EAAE,oBAAoB,CAAC,OAAO,EAAE,CAAC,GACpE,CACR,CAAC,CAAC,CAAC,IAAI,EACR,KAAC,oBAAoB,IACnB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,CAAC,eAAe,EAC1B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,EACjC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;oDACrB,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;gDAC/B,CAAC,GACD,IACE,GACF,EACN,eAAK,SAAS,EAAC,sBAAsB,aAClC,eAAe,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAC7C,KAAC,qBAAqB,IAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,GAAI,CAC5G,CAAC,CAAC,CAAC,IAAI,EACR,KAAC,mBAAmB,IAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,kBAAkB,CAAC,GAAI,EACvH,YAAY,CAAC,CAAC,CAAC,CACd,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,4CAA4C,gBAC1C,CAAC,CAAC,iBAAiB,CAAC,EAChC,KAAK,EAAE,CAAC,CAAC,iBAAiB,CAAC,EAC3B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,YAAY,YAEpB,CAAC,CAAC,MAAM,CAAC,GACH,CACV,CAAC,CAAC,CAAC,IAAI,EACR,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,4CAA4C,gBAC1C,CAAC,CAAC,OAAO,CAAC,EACtB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,EACjB,OAAO,EAAE,OAAO,YAEf,CAAC,CAAC,OAAO,CAAC,GACJ,IACL,IACC,EACT,KAAC,mBAAmB,IAClB,eAAe,EAAE,eAAe,EAChC,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,eAAe,CAAC,EACnD,QAAQ,EAAE,QAAQ,EAClB,eAAe,EAAE,OAAO,EACxB,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,OAAO,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EACvF,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,cAAc,GAC9B,IACE,IACF,GACF,EACN,QAAQ,CAAC,IAAI,CACd,CAAC;AACJ,CAAC"}

package/dist/features/version-manager/react/components/VersionPreviewFrame.d.ts

@@ -0,0 +1,17 @@
+import type { ViewportPreset } from '../../../viewer-shell/index.js';
+export interface VersionPreviewFrameProps {
+    previewDocument: string;
+    frameReady: boolean;
+    onFrameLoad: () => void;
+    viewport: string;
+    viewportPresets: ViewportPreset[];
+    title: string;
+    error: string | null;
+    loading: boolean;
+    loadingContent: boolean;
+}
+/** The scaled, sandboxed preview iframe + its loading overlay. Measures its
+ *  own container so a fixed-size viewport preset (tablet/mobile) can be
+ *  scaled to fit whatever space the host actually gives this pane. */
+export declare function VersionPreviewFrame({ previewDocument, frameReady, onFrameLoad, viewport, viewportPresets, title, error, loading, loadingContent, }: VersionPreviewFrameProps): import("react").JSX.Element;
+//# sourceMappingURL=VersionPreviewFrame.d.ts.map

package/dist/features/version-manager/react/components/VersionPreviewFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionPreviewFrame.d.ts","sourceRoot":"","sources":["../../../../../src/features/version-manager/react/components/VersionPreviewFrame.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAUrE,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;sEAEsE;AACtE,wBAAgB,mBAAmB,CAAC,EAClC,eAAe,EACf,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,EACf,KAAK,EACL,KAAK,EACL,OAAO,EACP,cAAc,GACf,EAAE,wBAAwB,+BAuC1B"}

package/dist/features/version-manager/react/components/VersionPreviewFrame.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useT } from '../../../i18n/index.js';
+import { effectivePreviewScale, findViewportPreset, previewScaleShellStyle, previewViewportStyle, } from '../../rules.js';
+import { DEFAULT_PREVIEW_CANVAS_PADDING } from '../../constants.js';
+import { usePreviewCanvasSize } from '../hooks/usePreviewCanvasSize.js';
+/** The scaled, sandboxed preview iframe + its loading overlay. Measures its
+ *  own container so a fixed-size viewport preset (tablet/mobile) can be
+ *  scaled to fit whatever space the host actually gives this pane. */
+export function VersionPreviewFrame({ previewDocument, frameReady, onFrameLoad, viewport, viewportPresets, title, error, loading, loadingContent, }) {
+    const t = useT();
+    const [frameRef, canvasSize] = usePreviewCanvasSize();
+    const preset = findViewportPreset(viewportPresets, viewport);
+    const scale = effectivePreviewScale(preset, 1, canvasSize, DEFAULT_PREVIEW_CANVAS_PADDING);
+    return (_jsx("div", { className: "jini-version-preview", ref: frameRef, children: error ? (_jsx("div", { className: "jini-viewer-empty", role: "alert", children: error })) : (_jsxs(_Fragment, { children: [previewDocument ? (_jsx("div", { className: "jini-preview-viewport", style: previewViewportStyle(preset, scale, 1), children: _jsx("div", { className: "jini-preview-frame-clip", children: _jsx("div", { style: previewScaleShellStyle(preset, 1), children: _jsx("iframe", { title: title, sandbox: "allow-scripts allow-downloads", srcDoc: previewDocument, onLoad: onFrameLoad }) }) }) })) : !loading && !loadingContent ? (_jsx("div", { className: "jini-viewer-empty", children: t('No preview available.') })) : null, loading || loadingContent || (previewDocument && !frameReady) ? (_jsx("div", { className: "jini-version-preview-overlay", role: "status", "aria-label": t('Loading preview…'), children: _jsx("span", { className: "jini-version-preview-spinner", "aria-hidden": "true" }) })) : null] })) }));
+}
+//# sourceMappingURL=VersionPreviewFrame.js.map

package/dist/features/version-manager/react/components/VersionPreviewFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionPreviewFrame.js","sourceRoot":"","sources":["../../../../../src/features/version-manager/react/components/VersionPreviewFrame.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAcxE;;sEAEsE;AACtE,MAAM,UAAU,mBAAmB,CAAC,EAClC,eAAe,EACf,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,EACf,KAAK,EACL,KAAK,EACL,OAAO,EACP,cAAc,GACW;IACzB,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,oBAAoB,EAAkB,CAAC;IACtE,MAAM,MAAM,GAAG,kBAAkB,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,8BAA8B,CAAC,CAAC;IAE3F,OAAO,CACL,cAAK,SAAS,EAAC,sBAAsB,EAAC,GAAG,EAAE,QAAQ,YAChD,KAAK,CAAC,CAAC,CAAC,CACP,cAAK,SAAS,EAAC,mBAAmB,EAAC,IAAI,EAAC,OAAO,YAC5C,KAAK,GACF,CACP,CAAC,CAAC,CAAC,CACF,8BACG,eAAe,CAAC,CAAC,CAAC,CACjB,cAAK,SAAS,EAAC,uBAAuB,EAAC,KAAK,EAAE,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,YAClF,cAAK,SAAS,EAAC,yBAAyB,YACtC,cAAK,KAAK,EAAE,sBAAsB,CAAC,MAAM,EAAE,CAAC,CAAC,YAC3C,iBACE,KAAK,EAAE,KAAK,EACZ,OAAO,EAAC,+BAA+B,EACvC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,WAAW,GACnB,GACE,GACF,GACF,CACP,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAChC,cAAK,SAAS,EAAC,mBAAmB,YAAE,CAAC,CAAC,uBAAuB,CAAC,GAAO,CACtE,CAAC,CAAC,CAAC,IAAI,EACP,OAAO,IAAI,cAAc,IAAI,CAAC,eAAe,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAC/D,cAAK,SAAS,EAAC,8BAA8B,EAAC,IAAI,EAAC,QAAQ,gBAAa,CAAC,CAAC,kBAAkB,CAAC,YAC3F,eAAM,SAAS,EAAC,8BAA8B,iBAAa,MAAM,GAAG,GAChE,CACP,CAAC,CAAC,CAAC,IAAI,IACP,CACJ,GACG,CACP,CAAC;AACJ,CAAC"}

package/dist/features/version-manager/react/components/VersionPromptPopover.d.ts

@@ -0,0 +1,24 @@
+export interface VersionPromptPopoverProps {
+    /** The generating prompt for the selected version, already trimmed.
+     *  Empty string when the selected version has none. */
+    prompt: string;
+    /** Disable the toggle entirely (no version selected). */
+    disabled: boolean;
+    /** True for a short window after a successful copy. Owned by the parent
+     *  (a `useCopyToClipboard` hook, e.g. `features/viewer-shell/`'s) rather
+     *  than by this component — this component stays props-in/JSX-out for
+     *  its business logic, only the open/close disclosure state is local. */
+    copied: boolean;
+    onCopy: (text: string) => void;
+    /** Notified whenever this popover's own open/close disclosure state
+     *  changes, so a host (e.g. `VersionManagerModal`) can gate its own
+     *  Escape handling while this popover is showing — without lifting the
+     *  disclosure state itself out of this component. */
+    onOpenChange?: (open: boolean) => void;
+}
+/** Disclosure showing the AI-generation prompt behind the selected version,
+ *  with a copy button. Open/close is small local UI state (acceptable per
+ *  this package's hook-ownership discipline); copy-to-clipboard itself is
+ *  injected, not reimplemented here. */
+export declare function VersionPromptPopover({ prompt, disabled, copied, onCopy, onOpenChange }: VersionPromptPopoverProps): import("react").JSX.Element;
+//# sourceMappingURL=VersionPromptPopover.d.ts.map

package/dist/features/version-manager/react/components/VersionPromptPopover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionPromptPopover.d.ts","sourceRoot":"","sources":["../../../../../src/features/version-manager/react/components/VersionPromptPopover.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,yBAAyB;IACxC;2DACuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,EAAE,OAAO,CAAC;IAClB;;;6EAGyE;IACzE,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B;;;yDAGqD;IACrD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAED;;;wCAGwC;AACxC,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,yBAAyB,+BA2CjH"}

package/dist/features/version-manager/react/components/VersionPromptPopover.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId, useRef, useState } from 'react';
+import { useDismissOnOutsideOrEscape } from '../../../../browser/index.js';
+import { useT } from '../../../i18n/index.js';
+/** Disclosure showing the AI-generation prompt behind the selected version,
+ *  with a copy button. Open/close is small local UI state (acceptable per
+ *  this package's hook-ownership discipline); copy-to-clipboard itself is
+ *  injected, not reimplemented here. */
+export function VersionPromptPopover({ prompt, disabled, copied, onCopy, onOpenChange }) {
+    const t = useT();
+    const [open, setOpen] = useState(false);
+    const wrapRef = useRef(null);
+    const popoverId = useId();
+    useDismissOnOutsideOrEscape(() => {
+        setOpen(false);
+        onOpenChange?.(false);
+    }, { enabled: open, containerRef: wrapRef });
+    return (_jsxs("div", { className: "jini-version-prompt-popover-wrap", ref: wrapRef, children: [_jsx("button", { type: "button", className: `jini-version-prompt-toggle${open ? ' active' : ''}`, "aria-expanded": open, "aria-controls": open ? popoverId : undefined, disabled: disabled, onClick: () => {
+                    const next = !open;
+                    setOpen(next);
+                    onOpenChange?.(next);
+                }, children: t('Prompt') }), open ? (_jsxs("section", { className: "jini-version-prompt-popover", id: popoverId, role: "region", "aria-label": t('Prompt'), children: [_jsxs("div", { className: "jini-version-prompt-head", children: [_jsx("h3", { children: t('Prompt') }), _jsx("button", { type: "button", className: "jini-viewer-action", disabled: !prompt, onClick: () => onCopy(prompt), children: copied ? t('Copied') : t('Copy') })] }), _jsx("p", { children: prompt || t('This version has no recorded prompt.') })] })) : null] }));
+}
+//# sourceMappingURL=VersionPromptPopover.js.map

package/dist/features/version-manager/react/components/VersionPromptPopover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionPromptPopover.js","sourceRoot":"","sources":["../../../../../src/features/version-manager/react/components/VersionPromptPopover.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAqB9C;;;wCAGwC;AACxC,MAAM,UAAU,oBAAoB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAA6B;IAChH,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,KAAK,EAAE,CAAC;IAE1B,2BAA2B,CACzB,GAAG,EAAE;QACH,OAAO,CAAC,KAAK,CAAC,CAAC;QACf,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CACzC,CAAC;IAEF,OAAO,CACL,eAAK,SAAS,EAAC,kCAAkC,EAAC,GAAG,EAAE,OAAO,aAC5D,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,6BAA6B,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,mBAChD,IAAI,mBACJ,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAC3C,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,GAAG,EAAE;oBACZ,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC;oBACnB,OAAO,CAAC,IAAI,CAAC,CAAC;oBACd,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC;gBACvB,CAAC,YAEA,CAAC,CAAC,QAAQ,CAAC,GACL,EACR,IAAI,CAAC,CAAC,CAAC,CACN,mBAAS,SAAS,EAAC,6BAA6B,EAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAC,QAAQ,gBAAa,CAAC,CAAC,QAAQ,CAAC,aACnG,eAAK,SAAS,EAAC,0BAA0B,aACvC,uBAAK,CAAC,CAAC,QAAQ,CAAC,GAAM,EACtB,iBAAQ,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,oBAAoB,EAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,YAClG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAC1B,IACL,EACN,sBAAI,MAAM,IAAI,CAAC,CAAC,sCAAsC,CAAC,GAAK,IACpD,CACX,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC;AACJ,CAAC"}

package/dist/features/version-manager/react/components/VersionRestoreControl.d.ts

@@ -0,0 +1,10 @@
+export interface VersionRestoreControlProps {
+    disabled: boolean;
+    restoring: boolean;
+    onRestore: () => void;
+}
+/** Restore button with a confirm-before-acting popover. Local
+ *  open/close disclosure state per this package's hook-ownership
+ *  discipline; the actual restore call is injected. */
+export declare function VersionRestoreControl({ disabled, restoring, onRestore }: VersionRestoreControlProps): import("react").JSX.Element;
+//# sourceMappingURL=VersionRestoreControl.d.ts.map

package/dist/features/version-manager/react/components/VersionRestoreControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionRestoreControl.d.ts","sourceRoot":"","sources":["../../../../../src/features/version-manager/react/components/VersionRestoreControl.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;uDAEuD;AACvD,wBAAgB,qBAAqB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,0BAA0B,+BA6CnG"}

package/dist/features/version-manager/react/components/VersionRestoreControl.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId, useRef, useState } from 'react';
+import { useDismissOnOutsideOrEscape } from '../../../../browser/index.js';
+import { useT } from '../../../i18n/index.js';
+/** Restore button with a confirm-before-acting popover. Local
+ *  open/close disclosure state per this package's hook-ownership
+ *  discipline; the actual restore call is injected. */
+export function VersionRestoreControl({ disabled, restoring, onRestore }) {
+    const t = useT();
+    const [confirmOpen, setConfirmOpen] = useState(false);
+    const wrapRef = useRef(null);
+    const popoverId = useId();
+    useDismissOnOutsideOrEscape(() => setConfirmOpen(false), { enabled: confirmOpen, containerRef: wrapRef });
+    return (_jsxs("div", { className: "jini-version-restore-wrap", ref: wrapRef, children: [_jsx("button", { type: "button", className: `jini-viewer-action primary jini-version-restore-action${confirmOpen ? ' active' : ''}`, disabled: disabled, "aria-haspopup": "dialog", "aria-expanded": confirmOpen, "aria-controls": confirmOpen ? popoverId : undefined, onClick: () => setConfirmOpen((value) => !value), children: restoring ? t('Restoring…') : t('Restore this version') }), confirmOpen ? (_jsxs("div", { className: "jini-version-restore-confirm", id: popoverId, role: "dialog", "aria-label": t('Restore this version?'), children: [_jsx("h3", { children: t('Restore this version?') }), _jsx("p", { children: t('The file’s current content will be replaced with this version.') }), _jsxs("div", { className: "jini-version-restore-confirm-actions", children: [_jsx("button", { type: "button", className: "jini-viewer-action", onClick: () => setConfirmOpen(false), children: t('Cancel') }), _jsx("button", { type: "button", className: "jini-viewer-action primary", disabled: disabled, onClick: () => {
+                                    setConfirmOpen(false);
+                                    onRestore();
+                                }, children: t('Restore') })] })] })) : null] }));
+}
+//# sourceMappingURL=VersionRestoreControl.js.map

package/dist/features/version-manager/react/components/VersionRestoreControl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionRestoreControl.js","sourceRoot":"","sources":["../../../../../src/features/version-manager/react/components/VersionRestoreControl.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAQ9C;;uDAEuD;AACvD,MAAM,UAAU,qBAAqB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAA8B;IAClG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,KAAK,EAAE,CAAC;IAE1B,2BAA2B,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;IAE1G,OAAO,CACL,eAAK,SAAS,EAAC,2BAA2B,EAAC,GAAG,EAAE,OAAO,aACrD,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,yDAAyD,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAClG,QAAQ,EAAE,QAAQ,mBACJ,QAAQ,mBACP,WAAW,mBACX,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAClD,OAAO,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,YAE/C,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,GACjD,EACR,WAAW,CAAC,CAAC,CAAC,CACb,eAAK,SAAS,EAAC,8BAA8B,EAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAC,QAAQ,gBAAa,CAAC,CAAC,uBAAuB,CAAC,aAC/G,uBAAK,CAAC,CAAC,uBAAuB,CAAC,GAAM,EACrC,sBAAI,CAAC,CAAC,gEAAgE,CAAC,GAAK,EAC5E,eAAK,SAAS,EAAC,sCAAsC,aACnD,iBAAQ,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,oBAAoB,EAAC,OAAO,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,YACtF,CAAC,CAAC,QAAQ,CAAC,GACL,EACT,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,4BAA4B,EACtC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,GAAG,EAAE;oCACZ,cAAc,CAAC,KAAK,CAAC,CAAC;oCACtB,SAAS,EAAE,CAAC;gCACd,CAAC,YAEA,CAAC,CAAC,SAAS,CAAC,GACN,IACL,IACF,CACP,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC;AACJ,CAAC"}

package/dist/features/version-manager/react/components/VersionSidebar.d.ts

@@ -0,0 +1,21 @@
+import type { VersionRecord } from '../../types.js';
+export interface VersionSidebarProps<TVersion extends VersionRecord> {
+    countLabel: string;
+    search: string;
+    onSearchChange: (value: string) => void;
+    showSearch: boolean;
+    loading: boolean;
+    versions: TVersion[];
+    visibleVersions: TVersion[];
+    selectedVersionId: string | null;
+    onSelect: (id: string) => void;
+    onPrefetch: (id: string) => void;
+    formatDate: (version: TVersion) => string;
+    sourceLabel: (version: TVersion) => string;
+    sourceClassName: (version: TVersion) => string;
+    restoredFrom: (version: TVersion) => TVersion | null;
+}
+/** The version list + search box half of the modal — sidebar navigation,
+ *  independent of whatever the preview pane is doing. */
+export declare function VersionSidebar<TVersion extends VersionRecord>({ countLabel, search, onSearchChange, showSearch, loading, versions, visibleVersions, selectedVersionId, onSelect, onPrefetch, formatDate, sourceLabel, sourceClassName, restoredFrom, }: VersionSidebarProps<TVersion>): import("react").JSX.Element;
+//# sourceMappingURL=VersionSidebar.d.ts.map

package/dist/features/version-manager/react/components/VersionSidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionSidebar.d.ts","sourceRoot":"","sources":["../../../../../src/features/version-manager/react/components/VersionSidebar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,mBAAmB,CAAC,QAAQ,SAAS,aAAa;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,eAAe,EAAE,QAAQ,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,MAAM,CAAC;IAC1C,WAAW,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,MAAM,CAAC;IAC3C,eAAe,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,MAAM,CAAC;IAC/C,YAAY,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,QAAQ,GAAG,IAAI,CAAC;CACtD;AAED;yDACyD;AACzD,wBAAgB,cAAc,CAAC,QAAQ,SAAS,aAAa,EAAE,EAC7D,UAAU,EACV,MAAM,EACN,cAAc,EACd,UAAU,EACV,OAAO,EACP,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACV,UAAU,EACV,WAAW,EACX,eAAe,EACf,YAAY,GACb,EAAE,mBAAmB,CAAC,QAAQ,CAAC,+BAiF/B"}

package/dist/features/version-manager/react/components/VersionSidebar.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useT } from '../../../i18n/index.js';
+/** The version list + search box half of the modal — sidebar navigation,
+ *  independent of whatever the preview pane is doing. */
+export function VersionSidebar({ countLabel, search, onSearchChange, showSearch, loading, versions, visibleVersions, selectedVersionId, onSelect, onPrefetch, formatDate, sourceLabel, sourceClassName, restoredFrom, }) {
+    const t = useT();
+    return (_jsxs("div", { className: "jini-version-sidebar", children: [_jsx("div", { className: "jini-version-sidebar-head", children: _jsx("span", { className: "jini-version-count", children: countLabel }) }), showSearch ? (_jsxs("div", { className: "jini-version-search", children: [_jsx("input", { type: "search", value: search, onChange: (event) => onSearchChange(event.target.value), placeholder: t('Search…'), "aria-label": t('Search…') }), search ? (_jsx("button", { type: "button", className: "jini-version-search-clear", "aria-label": t('Clear'), onClick: () => onSearchChange(''), children: t('Clear') })) : null] })) : null, _jsx("div", { className: "jini-version-list", role: "listbox", "aria-label": t('Version history'), children: loading ? (_jsx("div", { className: "jini-version-skeleton-list", role: "status", "aria-label": t('Loading versions…'), children: [0, 1, 2, 3].map((row) => (_jsx("div", { className: "jini-version-skeleton-item", "aria-hidden": "true" }, row))) })) : versions.length === 0 ? (_jsx("div", { className: "jini-version-empty", children: t('No versions yet.') })) : visibleVersions.length === 0 ? (_jsx("div", { className: "jini-version-empty", children: t('No results for “{query}”.', { query: search.trim() }) })) : (visibleVersions.map((version) => {
+                    const selected = version.id === selectedVersionId;
+                    const itemRestoredFrom = restoredFrom(version);
+                    const prefetch = () => onPrefetch(version.id);
+                    return (_jsxs("button", { type: "button", className: `jini-version-item${selected ? ' active' : ''}`, role: "option", "aria-selected": selected, onClick: () => onSelect(version.id), onMouseEnter: prefetch, onFocus: prefetch, children: [_jsxs("span", { className: "jini-version-item-top", children: [version.current ? _jsx("span", { className: "jini-version-current-badge", children: t('Current') }) : null, _jsx("span", { className: `jini-version-source-badge ${sourceClassName(version)}`, children: sourceLabel(version) }), _jsx("span", { className: "jini-version-time", children: formatDate(version) })] }), _jsx("span", { className: "jini-version-item-title", children: version.prompt || version.label || t('Version {version}', { version: version.version }) }), _jsxs("span", { className: "jini-version-item-meta", children: [t('Version {version}', { version: version.version }), itemRestoredFrom ? (_jsx("span", { className: "jini-version-item-restored", children: t('Restored from v{version}', { version: itemRestoredFrom.version }) })) : null] })] }, version.id));
+                })) })] }));
+}
+//# sourceMappingURL=VersionSidebar.js.map

package/dist/features/version-manager/react/components/VersionSidebar.js.map

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

package/dist/features/version-manager/react/hooks/usePreviewCanvasSize.d.ts

@@ -0,0 +1,10 @@
+import type { RefObject } from 'react';
+import type { PreviewCanvasSize } from '../../types.js';
+/**
+ * Measures an element's content-box size, re-measuring on resize (via
+ * `ResizeObserver` when available) and on the window `resize` event as a
+ * fallback. Used to fit a fixed-size viewport preset (tablet/mobile) inside
+ * whatever space the host actually gives the preview pane.
+ */
+export declare function usePreviewCanvasSize<T extends HTMLElement>(): [RefObject<T | null>, PreviewCanvasSize | undefined];
+//# sourceMappingURL=usePreviewCanvasSize.d.ts.map

package/dist/features/version-manager/react/hooks/usePreviewCanvasSize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreviewCanvasSize.d.ts","sourceRoot":"","sources":["../../../../../src/features/version-manager/react/hooks/usePreviewCanvasSize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,WAAW,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC,CA8BlH"}

package/dist/features/version-manager/react/hooks/usePreviewCanvasSize.js

@@ -0,0 +1,38 @@
+import { useEffect, useRef, useState } from 'react';
+/**
+ * Measures an element's content-box size, re-measuring on resize (via
+ * `ResizeObserver` when available) and on the window `resize` event as a
+ * fallback. Used to fit a fixed-size viewport preset (tablet/mobile) inside
+ * whatever space the host actually gives the preview pane.
+ */
+export function usePreviewCanvasSize() {
+    const ref = useRef(null);
+    const [size, setSize] = useState(undefined);
+    useEffect(() => {
+        // No `typeof window === 'undefined'` SSR guard here: a `useEffect` body
+        // never runs during server rendering (effects only fire post-mount on
+        // the client, where `window` always exists) — a guard here would be
+        // dead code, not a real defense. See this package's Phase 9.5
+        // dead-branch-gets-refactored-away rule.
+        const el = ref.current;
+        if (!el)
+            return;
+        const measure = () => {
+            const rect = el.getBoundingClientRect();
+            setSize({ width: rect.width, height: rect.height });
+        };
+        measure();
+        let observer = null;
+        if (typeof ResizeObserver !== 'undefined') {
+            observer = new ResizeObserver(measure);
+            observer.observe(el);
+        }
+        window.addEventListener('resize', measure);
+        return () => {
+            observer?.disconnect();
+            window.removeEventListener('resize', measure);
+        };
+    }, []);
+    return [ref, size];
+}
+//# sourceMappingURL=usePreviewCanvasSize.js.map

package/dist/features/version-manager/react/hooks/usePreviewCanvasSize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreviewCanvasSize.js","sourceRoot":"","sources":["../../../../../src/features/version-manager/react/hooks/usePreviewCanvasSize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAIpD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,GAAG,MAAM,CAAW,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAgC,SAAS,CAAC,CAAC;IAE3E,SAAS,CAAC,GAAG,EAAE;QACb,wEAAwE;QACxE,sEAAsE;QACtE,oEAAoE;QACpE,8DAA8D;QAC9D,yCAAyC;QACzC,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC;YACxC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC;QACF,OAAO,EAAE,CAAC;QACV,IAAI,QAAQ,GAA0B,IAAI,CAAC;QAC3C,IAAI,OAAO,cAAc,KAAK,WAAW,EAAE,CAAC;YAC1C,QAAQ,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;YACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;QACD,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,GAAG,EAAE;YACV,QAAQ,EAAE,UAAU,EAAE,CAAC;YACvB,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACrB,CAAC"}

package/dist/features/version-manager/react/hooks/useVersionManager.d.ts

@@ -0,0 +1,67 @@
+import type { ViewportPreset } from '../../../viewer-shell/index.js';
+import type { VersionManagerDependencies } from '../../ports.js';
+import type { VersionManagerFileRef, VersionRecord } from '../../types.js';
+export interface UseVersionManagerOptions<TVersion extends VersionRecord> {
+    fileRef: VersionManagerFileRef;
+    /** The file's current (pre-version-history) content, used to seed the
+     *  cache so the version flagged `current` renders instantly with no
+     *  round-trip. `null` if there is none yet. */
+    currentContent: string | null;
+    onRestored: (content: string, version: TVersion) => Promise<void> | void;
+    /** Called after a restore completes with no warning — matches the
+     *  source, which closes the modal immediately on a clean restore but
+     *  keeps it open (showing the warning) when the restore succeeded with
+     *  a caveat. Omit if the host wants to keep the modal open regardless. */
+    onRestoredCleanly?: () => void;
+    viewportPresets?: ViewportPreset[];
+}
+export interface VersionManagerController<TVersion extends VersionRecord> {
+    versions: TVersion[];
+    visibleVersions: TVersion[];
+    versionById: ReadonlyMap<string, TVersion>;
+    selectedVersion: TVersion | null;
+    selectedId: string | null;
+    selectVersion: (id: string) => void;
+    prefetchVersion: (id: string) => void;
+    restoredFrom: (version: TVersion) => TVersion | null;
+    loading: boolean;
+    loadingContent: boolean;
+    error: string | null;
+    search: string;
+    setSearch: (value: string) => void;
+    showSearch: boolean;
+    selectedContent: string | null;
+    previewDocument: string;
+    frameReady: boolean;
+    markFrameLoaded: (document: string) => void;
+    restoring: boolean;
+    restoreDisabled: boolean;
+    restore: () => Promise<void>;
+    openInNewTab: (() => void) | null;
+    viewportPresets: ViewportPreset[];
+    viewport: string;
+    setViewport: (id: string) => void;
+    describeVersion: (version: TVersion) => string;
+}
+/**
+ * Owns the whole version-manager state machine: list fetch, selection,
+ * content cache/prefetch, search, restore, and viewport choice. Kept as one
+ * cohesive hook per this package's Phase 6 "one natural owning cluster"
+ * discipline (matching `features/connectors/`'s `useConnectorAuthorization`
+ * precedent) — the source's own version, list, and preview state are all
+ * read/written by each other's effects and don't split cleanly.
+ */
+export declare function useVersionManager<TVersion extends VersionRecord>(dependencies: VersionManagerDependencies<TVersion>, options: UseVersionManagerOptions<TVersion>): VersionManagerController<TVersion>;
+/**
+ * Production wiring for `useVersionManager`: binds the module-level default
+ * dependencies singleton (a stateless fake port + the real stateless
+ * browser clipboard — see `dependencies.ts`'s `defaultVersionManagerDependencies`
+ * for why this must stay ONE shared instance rather than a fresh call per
+ * render: a fresh `dependencies.versions` identity every render would
+ * re-trigger `loadVersions`'s effect in a loop, the same reasoning
+ * `useWiredCopyToClipboard` in `features/viewer-shell/` documents for its
+ * own singleton). A real host supplies its own `VersionManagerDependencies`
+ * directly to `useVersionManager` instead of using this wirer.
+ */
+export declare function useWiredVersionManager<TVersion extends VersionRecord>(options: UseVersionManagerOptions<TVersion>, dependencies?: VersionManagerDependencies<TVersion>): VersionManagerController<TVersion>;
+//# sourceMappingURL=useVersionManager.d.ts.map

package/dist/features/version-manager/react/hooks/useVersionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVersionManager.d.ts","sourceRoot":"","sources":["../../../../../src/features/version-manager/react/hooks/useVersionManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAOrE,OAAO,KAAK,EAAE,0BAA0B,EAAsB,MAAM,gBAAgB,CAAC;AAarF,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE3E,MAAM,WAAW,wBAAwB,CAAC,QAAQ,SAAS,aAAa;IACtE,OAAO,EAAE,qBAAqB,CAAC;IAC/B;;mDAE+C;IAC/C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACzE;;;8EAG0E;IAC1E,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,wBAAwB,CAAC,QAAQ,SAAS,aAAa;IACtE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,eAAe,EAAE,QAAQ,EAAE,CAAC;IAC5B,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3C,eAAe,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,YAAY,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,QAAQ,GAAG,IAAI,CAAC;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,YAAY,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,eAAe,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,MAAM,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,SAAS,aAAa,EAC9D,YAAY,EAAE,0BAA0B,CAAC,QAAQ,CAAC,EAClD,OAAO,EAAE,wBAAwB,CAAC,QAAQ,CAAC,GAC1C,wBAAwB,CAAC,QAAQ,CAAC,CAgSpC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,SAAS,aAAa,EACnE,OAAO,EAAE,wBAAwB,CAAC,QAAQ,CAAC,EAC3C,YAAY,GAAE,0BAA0B,CAAC,QAAQ,CAAwF,GACxI,wBAAwB,CAAC,QAAQ,CAAC,CAEpC"}