@jini-ai/ui 0.1.0

package/dist/features/file-dropzone/react/hooks/useFileDropzone.js

@@ -0,0 +1,135 @@
+import { useEffect, useRef } from 'react';
+import { useFileDropTarget } from '../../../../browser/useFileDropTarget.js';
+import { filesFromClipboardData, shouldIgnoreClipboardFilePaste } from '../../../../utils/file-transfer.js';
+import { FILE_DROPZONE_PROCESSING_BYTES_THRESHOLD, FILE_DROPZONE_PROCESSING_FILE_COUNT_THRESHOLD, FILE_DROPZONE_PROCESSING_MIN_VISIBLE_MS } from '../../constants.js';
+import { fileDropzoneShouldShowProcessing } from '../../rules.js';
+import { useFileDialogTracking } from './useFileDialogTracking.js';
+function runAfterNextPaint(callback) {
+    if (typeof window.requestAnimationFrame === 'function') {
+        window.requestAnimationFrame(() => window.setTimeout(callback, 0));
+        return;
+    }
+    window.setTimeout(callback, 0);
+}
+/**
+ * Consolidates the two independent OD file-staging zones'
+ * behavior into one hook: native drag/drop (directory-aware, via
+ * `browser/useFileDropTarget`), click-to-browse (with the file-dialog
+ * cancel-vs-still-loading detection heuristic, via `useFileDialogTracking`),
+ * an optional page-wide clipboard-paste listener, and the shared
+ * large-selection loading-affordance heuristic that gates all of the above
+ * except paste. See `packages/ui/source-map.md` for the full consolidation
+ * writeup and which origin file contributed which piece.
+ */
+export function useFileDropzone({ onFiles, onZoneClick, onError, onProcessingStart, enablePaste = false, }) {
+    const inputRef = useRef(null);
+    const onFilesRef = useRef(onFiles);
+    onFilesRef.current = onFiles;
+    const onErrorRef = useRef(onError);
+    onErrorRef.current = onError;
+    const dialogTracking = useFileDialogTracking(onProcessingStart);
+    const dialogTrackingRef = useRef(dialogTracking);
+    dialogTrackingRef.current = dialogTracking;
+    function finishProcessingLater(finish) {
+        if (!finish)
+            return;
+        window.setTimeout(finish, FILE_DROPZONE_PROCESSING_MIN_VISIBLE_MS);
+    }
+    // Every caller (processSelectedFiles' two staging branches, and the paste
+    // listener) already guards a non-empty selection before reaching here, so
+    // this has no empty-array case to handle.
+    function stageFiles(nextFiles) {
+        onErrorRef.current?.(null);
+        onFilesRef.current(nextFiles);
+    }
+    function processSelectedFiles(nextFiles, activeFinish) {
+        if (nextFiles.length === 0) {
+            finishProcessingLater(activeFinish);
+            return;
+        }
+        if (!fileDropzoneShouldShowProcessing(nextFiles, FILE_DROPZONE_PROCESSING_FILE_COUNT_THRESHOLD, FILE_DROPZONE_PROCESSING_BYTES_THRESHOLD) || !onProcessingStart) {
+            stageFiles(nextFiles);
+            finishProcessingLater(activeFinish);
+            return;
+        }
+        const finish = activeFinish ?? onProcessingStart();
+        runAfterNextPaint(() => {
+            try {
+                stageFiles(nextFiles);
+            }
+            finally {
+                finishProcessingLater(finish);
+            }
+        });
+    }
+    const dragTarget = useFileDropTarget((droppedFiles) => processSelectedFiles(droppedFiles));
+    // Mirrors the drag-target's own read-error state into the `onError` prop
+    // so a host that already has a single error-display slot (matching the
+    // origin `DropZone`'s `onError` contract) doesn't need a second one just
+    // for drops; `dragTarget.dropReadError` remains available directly too
+    // for a host that prefers to render its own inline banner instead.
+    useEffect(() => {
+        if (dragTarget.dropReadError)
+            onErrorRef.current?.(dragTarget.dropReadError);
+    }, [dragTarget.dropReadError]);
+    function openPicker() {
+        inputRef.current?.click();
+    }
+    function onInputClick() {
+        onZoneClick?.();
+        dialogTrackingRef.current.prepareTracking();
+    }
+    function onInputChange(event) {
+        const picked = Array.from(event.currentTarget.files ?? []);
+        event.currentTarget.value = '';
+        const finish = dialogTrackingRef.current.completeTracking();
+        processSelectedFiles(picked, finish);
+    }
+    // The native `cancel` event on `<input type=file>` has no React synthetic
+    // equivalent, so it's wired imperatively — mirroring the origin, which
+    // only attaches this (and the window `focus` listener now owned by
+    // `useFileDialogTracking`) while a processing affordance is configured.
+    useEffect(() => {
+        if (!onProcessingStart)
+            return undefined;
+        // Non-null: this effect runs post-mount, and the consumer always
+        // renders the ref'd `<input>` unconditionally (see `FileDropzone.tsx`),
+        // so `inputRef.current` is never null once an effect body executes.
+        const input = inputRef.current;
+        function handleCancel() {
+            dialogTrackingRef.current.handleDialogCancelled();
+        }
+        input.addEventListener('cancel', handleCancel);
+        return () => input.removeEventListener('cancel', handleCancel);
+    }, [onProcessingStart]);
+    useEffect(() => {
+        if (!enablePaste)
+            return undefined;
+        function onPaste(event) {
+            if (shouldIgnoreClipboardFilePaste(event.target) || shouldIgnoreClipboardFilePaste(document.activeElement)) {
+                return;
+            }
+            const pasted = filesFromClipboardData(event.clipboardData);
+            if (pasted.length === 0)
+                return;
+            event.preventDefault();
+            stageFiles(pasted);
+        }
+        window.addEventListener('paste', onPaste);
+        return () => window.removeEventListener('paste', onPaste);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [enablePaste]);
+    return {
+        inputRef,
+        dragOver: dragTarget.draggingFiles,
+        dropReadError: dragTarget.dropReadError,
+        openPicker,
+        onZoneDragEnter: dragTarget.onDragEnter,
+        onZoneDragOver: dragTarget.onDragOver,
+        onZoneDragLeave: dragTarget.onDragLeave,
+        onZoneDrop: dragTarget.onDrop,
+        onInputChange,
+        onInputClick,
+    };
+}
+//# sourceMappingURL=useFileDropzone.js.map

package/dist/features/file-dropzone/react/hooks/useFileDropzone.js.map

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

package/dist/features/file-dropzone/react/hooks/useFileDropzonePreviews.d.ts

@@ -0,0 +1,9 @@
+import type { FileDropzonePreviewState } from '../../types.js';
+/**
+ * Derives preview state for every staged `file` that can render one:
+ * object URLs (image/video/audio/pdf/html/font), loaded `FontFace` family
+ * names, and bounded text snippets. Ported from
+ * `DesignSystemAssetDropzone.tsx`'s three `files`-keyed effects.
+ */
+export declare function useFileDropzonePreviews(files: readonly File[]): FileDropzonePreviewState;
+//# sourceMappingURL=useFileDropzonePreviews.d.ts.map

package/dist/features/file-dropzone/react/hooks/useFileDropzonePreviews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileDropzonePreviews.d.ts","sourceRoot":"","sources":["../../../../../src/features/file-dropzone/react/hooks/useFileDropzonePreviews.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAoB/D;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,wBAAwB,CAkGxF"}

package/dist/features/file-dropzone/react/hooks/useFileDropzonePreviews.js

@@ -0,0 +1,133 @@
+import { useEffect, useState } from 'react';
+import { fileDropzoneFontFamilyName, fileDropzoneKind, fileDropzoneNeedsObjectUrl } from '../../rules.js';
+import { FILE_DROPZONE_TEXT_PREVIEW_BYTES } from '../../constants.js';
+/** Object URL for a file preview, or `null` where unavailable (e.g. no `URL.createObjectURL` in the current environment). */
+function createPreviewUrl(file) {
+    try {
+        if (typeof URL === 'undefined' || typeof URL.createObjectURL !== 'function')
+            return null;
+        return URL.createObjectURL(file);
+    }
+    catch {
+        return null;
+    }
+}
+function revokePreviewUrl(url) {
+    try {
+        URL.revokeObjectURL?.(url);
+    }
+    catch {
+        /* no-op */
+    }
+}
+/**
+ * Derives preview state for every staged `file` that can render one:
+ * object URLs (image/video/audio/pdf/html/font), loaded `FontFace` family
+ * names, and bounded text snippets. Ported from
+ * `DesignSystemAssetDropzone.tsx`'s three `files`-keyed effects.
+ */
+export function useFileDropzonePreviews(files) {
+    // Creation and revocation MUST be paired inside one `files`-keyed effect:
+    // the cleanup revokes exactly the URLs its own setup created. This is the
+    // StrictMode-safe shape — the origin's own doc comment on this effect
+    // explains the alternative (create in a `useMemo`, revoke in a separate
+    // empty-deps cleanup) breaks any preview staged at first mount, because
+    // StrictMode's simulated unmount fires the cleanup and revokes the URLs,
+    // then the remount hands back those now-dead `blob:` links.
+    const [previewUrls, setPreviewUrls] = useState(new Map());
+    useEffect(() => {
+        const next = new Map();
+        for (const file of files) {
+            if (!fileDropzoneNeedsObjectUrl(fileDropzoneKind(file)))
+                continue;
+            const url = createPreviewUrl(file);
+            if (url)
+                next.set(file, url);
+        }
+        setPreviewUrls(next);
+        return () => {
+            for (const url of next.values())
+                revokePreviewUrl(url);
+        };
+    }, [files]);
+    // Loads each staged font via the FontFace API so its thumbnail + lightbox
+    // can render a real specimen. Registered faces are removed on cleanup so
+    // re-staging never leaks families into `document.fonts`.
+    const [fontFamilies, setFontFamilies] = useState(new Map());
+    useEffect(() => {
+        if (typeof FontFace === 'undefined' || typeof document === 'undefined' || !document.fonts) {
+            return undefined;
+        }
+        let cancelled = false;
+        const ready = new Map();
+        const registered = [];
+        files.forEach((file, index) => {
+            if (fileDropzoneKind(file) !== 'font')
+                return;
+            const url = previewUrls.get(file);
+            if (!url)
+                return;
+            const family = fileDropzoneFontFamilyName(file, index);
+            try {
+                const face = new FontFace(family, `url(${url})`);
+                registered.push(face);
+                void face
+                    .load()
+                    .then((loaded) => {
+                    if (cancelled)
+                        return;
+                    document.fonts.add(loaded);
+                    ready.set(file, family);
+                    setFontFamilies(new Map(ready));
+                })
+                    .catch(() => {
+                    /* unreadable / unsupported font — falls back to the glyph */
+                });
+            }
+            catch {
+                /* FontFace construction failed — glyph fallback */
+            }
+        });
+        return () => {
+            cancelled = true;
+            for (const face of registered) {
+                try {
+                    document.fonts.delete(face);
+                }
+                catch {
+                    /* no-op */
+                }
+            }
+        };
+    }, [files, previewUrls]);
+    // Reads a bounded slice of each text-like file for a snippet thumbnail +
+    // scrollable lightbox preview. Capped so a large JSON/CSS never blocks.
+    const [textSnippets, setTextSnippets] = useState(new Map());
+    useEffect(() => {
+        const pending = files.filter((file) => fileDropzoneKind(file) === 'text');
+        if (pending.length === 0) {
+            setTextSnippets(new Map());
+            return undefined;
+        }
+        let cancelled = false;
+        const next = new Map();
+        void Promise.all(pending.map(async (file) => {
+            try {
+                const slice = typeof file.slice === 'function' ? file.slice(0, FILE_DROPZONE_TEXT_PREVIEW_BYTES) : file;
+                const text = await slice.text();
+                next.set(file, text);
+            }
+            catch {
+                /* unreadable — lightbox shows the name/size fallback */
+            }
+        })).then(() => {
+            if (!cancelled)
+                setTextSnippets(next);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [files]);
+    return { previewUrls, fontFamilies, textSnippets };
+}
+//# sourceMappingURL=useFileDropzonePreviews.js.map

package/dist/features/file-dropzone/react/hooks/useFileDropzonePreviews.js.map

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

package/dist/features/file-dropzone/rules.d.ts

@@ -0,0 +1,17 @@
+import type { FileDropzoneKind } from './types.js';
+/** Lowercased extension (no dot), or `''` for an extensionless name. */
+export declare function fileDropzoneExtension(file: File): string;
+/** MIME-first (authoritative when present), falling back to extension for files the browser typed as `application/octet-stream`. */
+export declare function fileDropzoneKind(file: File): FileDropzoneKind;
+/** Kinds renderable straight from an object URL (`blob:`). Fonts also need one (`FontFace` loads from a URL); text is read via `FileReader`/`Blob.text()` instead. */
+export declare function fileDropzoneNeedsObjectUrl(kind: FileDropzoneKind): boolean;
+/** Uppercased, 4-char-capped extension for the glyph badge (e.g. `"a/b.jpeg"` -> `"JPEG"`, extensionless -> `"FILE"`). */
+export declare function fileDropzoneExtensionLabel(file: File): string;
+export declare function fileDropzoneSizeLabel(bytes: number): string;
+/** A stable key for a staged `File` (name + size + mtime is collision-safe for the staging lists this feature renders). */
+export declare function fileDropzoneStagingKey(file: File): string;
+/** CSS-safe, collision-resistant `@font-face` family name for a staged font at `index`. */
+export declare function fileDropzoneFontFamilyName(file: File, index: number): string;
+/** Whether a selection is large enough (by count or total bytes) to warrant a loading affordance while it's staged. */
+export declare function fileDropzoneShouldShowProcessing(files: readonly File[], fileCountThreshold: number, totalBytesThreshold: number): boolean;
+//# sourceMappingURL=rules.d.ts.map

package/dist/features/file-dropzone/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/features/file-dropzone/rules.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAExD;AAED,oIAAoI;AACpI,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CAW7D;AAED,sKAAsK;AACtK,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAE1E;AAED,0HAA0H;AAC1H,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED,2HAA2H;AAC3H,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEzD;AAED,2FAA2F;AAC3F,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED,uHAAuH;AACvH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,kBAAkB,EAAE,MAAM,EAC1B,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAIT"}

package/dist/features/file-dropzone/rules.js

@@ -0,0 +1,63 @@
+/**
+ * Pure logic for the file-dropzone feature. No React, no DOM globals — every
+ * DOM-shaped value (`File`, event targets) arrives as a parameter.
+ */
+import { FILE_DROPZONE_KIND_BY_EXTENSION } from './constants.js';
+/** Lowercased extension (no dot), or `''` for an extensionless name. */
+export function fileDropzoneExtension(file) {
+    return (/\.([a-z0-9]+)$/i.exec(file.name)?.[1] ?? '').toLowerCase();
+}
+/** MIME-first (authoritative when present), falling back to extension for files the browser typed as `application/octet-stream`. */
+export function fileDropzoneKind(file) {
+    const type = file.type.toLowerCase();
+    const ext = fileDropzoneExtension(file);
+    if (type.startsWith('image/'))
+        return 'image';
+    if (type.startsWith('video/'))
+        return 'video';
+    if (type.startsWith('audio/'))
+        return 'audio';
+    if (type === 'application/pdf')
+        return 'pdf';
+    if (type === 'text/html')
+        return 'html';
+    if (type.startsWith('font/'))
+        return 'font';
+    if (type.startsWith('text/'))
+        return 'text';
+    return FILE_DROPZONE_KIND_BY_EXTENSION[ext] ?? 'other';
+}
+/** Kinds renderable straight from an object URL (`blob:`). Fonts also need one (`FontFace` loads from a URL); text is read via `FileReader`/`Blob.text()` instead. */
+export function fileDropzoneNeedsObjectUrl(kind) {
+    return kind === 'image' || kind === 'video' || kind === 'audio' || kind === 'pdf' || kind === 'html' || kind === 'font';
+}
+/** Uppercased, 4-char-capped extension for the glyph badge (e.g. `"a/b.jpeg"` -> `"JPEG"`, extensionless -> `"FILE"`). */
+export function fileDropzoneExtensionLabel(file) {
+    return (fileDropzoneExtension(file) || 'file').toUpperCase().slice(0, 4);
+}
+export function fileDropzoneSizeLabel(bytes) {
+    if (!bytes || bytes <= 0)
+        return '';
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${Math.round(bytes / 1024)} KB`;
+    return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+/** A stable key for a staged `File` (name + size + mtime is collision-safe for the staging lists this feature renders). */
+export function fileDropzoneStagingKey(file) {
+    return `${file.name}:${file.size}:${file.lastModified}`;
+}
+/** CSS-safe, collision-resistant `@font-face` family name for a staged font at `index`. */
+export function fileDropzoneFontFamilyName(file, index) {
+    const slug = file.name.replace(/[^a-z0-9]+/gi, '-').replace(/^-+|-+$/g, '').slice(0, 24);
+    return `jini-file-dropzone-font-${index}-${slug || 'font'}`;
+}
+/** Whether a selection is large enough (by count or total bytes) to warrant a loading affordance while it's staged. */
+export function fileDropzoneShouldShowProcessing(files, fileCountThreshold, totalBytesThreshold) {
+    if (files.length >= fileCountThreshold)
+        return true;
+    const totalBytes = files.reduce((sum, file) => sum + file.size, 0);
+    return totalBytes >= totalBytesThreshold;
+}
+//# sourceMappingURL=rules.js.map

package/dist/features/file-dropzone/rules.js.map

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

package/dist/features/file-dropzone/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pure types for the file-dropzone feature. No React.
+ *
+ * Consolidates two independent OD file-staging zones into one
+ * primitive (see `packages/ui/source-map.md` for the full consolidation
+ * writeup): `DesignSystemAssetDropzone.tsx` (a rich, kind-aware thumbnail
+ * grid over staged `File[]`) and `DesignSystemFlow.tsx`'s `DropZone` (a
+ * labeled, prompt-driven zone with a file-dialog cancel-vs-still-loading
+ * detection heuristic). Both are "a native drag/drop + click-to-browse
+ * surface that resolves to a flat `File[]`" — this type set covers the
+ * union of what either shape needs.
+ */
+/** The preview families this feature can render meaningfully in-browser. Anything else falls back to a typed glyph + filename. */
+export type FileDropzoneKind = 'image' | 'font' | 'pdf' | 'html' | 'video' | 'audio' | 'slides' | 'text' | 'other';
+/** Per-file preview state the thumbnail grid + lightbox render from — object URLs (image/video/audio/pdf/html/font), loaded font family names, and text snippets. */
+export interface FileDropzonePreviewState {
+    previewUrls: ReadonlyMap<File, string>;
+    fontFamilies: ReadonlyMap<File, string>;
+    textSnippets: ReadonlyMap<File, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/features/file-dropzone/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/file-dropzone/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kIAAkI;AAClI,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,MAAM,GACN,KAAK,GACL,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,CAAC;AAEZ,qKAAqK;AACrK,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,YAAY,EAAE,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,YAAY,EAAE,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;CACzC"}

package/dist/features/file-dropzone/types.js

@@ -0,0 +1,14 @@
+/**
+ * Pure types for the file-dropzone feature. No React.
+ *
+ * Consolidates two independent OD file-staging zones into one
+ * primitive (see `packages/ui/source-map.md` for the full consolidation
+ * writeup): `DesignSystemAssetDropzone.tsx` (a rich, kind-aware thumbnail
+ * grid over staged `File[]`) and `DesignSystemFlow.tsx`'s `DropZone` (a
+ * labeled, prompt-driven zone with a file-dialog cancel-vs-still-loading
+ * detection heuristic). Both are "a native drag/drop + click-to-browse
+ * surface that resolves to a flat `File[]`" — this type set covers the
+ * union of what either shape needs.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/file-dropzone/types.js.map

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

package/dist/features/html-viewer/constants.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A fresh, neutral `postMessage` protocol for deck navigation — deliberately
+ * NOT OD's `od:slide`/`od:slide-state` (see `packages/ui/source-map.md`'s
+ * `html-viewer` classification: the real bridge's 31 message types across 3
+ * naming conventions need a redesign, not a rename). Any sandboxed deck
+ * content this feature drives must speak this protocol:
+ *   host -> iframe: { type: DECK_NAVIGATE_MESSAGE_TYPE, action, index? }
+ *   iframe -> host: { type: DECK_STATE_MESSAGE_TYPE, active, count }
+ */
+export declare const DECK_NAVIGATE_MESSAGE_TYPE = "jini:deck-navigate";
+export declare const DECK_STATE_MESSAGE_TYPE = "jini:deck-state";
+/** Preset zoom percentages, matching the source's own dropdown levels. */
+export declare const DEFAULT_ZOOM_LEVELS: readonly [50, 75, 100, 125, 150, 200];
+/** Zoom is expressed as a whole-number percentage; 100 means "actual size." */
+export declare const DEFAULT_ZOOM = 100;
+//# sourceMappingURL=constants.d.ts.map

package/dist/features/html-viewer/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/features/html-viewer/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,uBAAuB,CAAC;AAC/D,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AAEzD,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,uCAAwC,CAAC;AAEzE,+EAA+E;AAC/E,eAAO,MAAM,YAAY,MAAM,CAAC"}

package/dist/features/html-viewer/constants.js

@@ -0,0 +1,16 @@
+/**
+ * A fresh, neutral `postMessage` protocol for deck navigation — deliberately
+ * NOT OD's `od:slide`/`od:slide-state` (see `packages/ui/source-map.md`'s
+ * `html-viewer` classification: the real bridge's 31 message types across 3
+ * naming conventions need a redesign, not a rename). Any sandboxed deck
+ * content this feature drives must speak this protocol:
+ *   host -> iframe: { type: DECK_NAVIGATE_MESSAGE_TYPE, action, index? }
+ *   iframe -> host: { type: DECK_STATE_MESSAGE_TYPE, active, count }
+ */
+export const DECK_NAVIGATE_MESSAGE_TYPE = 'jini:deck-navigate';
+export const DECK_STATE_MESSAGE_TYPE = 'jini:deck-state';
+/** Preset zoom percentages, matching the source's own dropdown levels. */
+export const DEFAULT_ZOOM_LEVELS = [50, 75, 100, 125, 150, 200];
+/** Zoom is expressed as a whole-number percentage; 100 means "actual size." */
+export const DEFAULT_ZOOM = 100;
+//# sourceMappingURL=constants.js.map

package/dist/features/html-viewer/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/features/html-viewer/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AAC/D,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAEzD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAEzE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC"}

package/dist/features/html-viewer/dependencies.d.ts

@@ -0,0 +1,8 @@
+import type { FullscreenPort, HtmlViewerDependencies, NewTabPreviewPort } from './ports.js';
+/** Real browser Fullscreen API binding. Every method is SSR-guarded (`typeof document === 'undefined'`). */
+export declare function createBrowserFullscreenPort(): FullscreenPort;
+/** Reuses `@jini-ai/renderers-react`'s `openSandboxedPreviewInNewTab` — the sandboxed-iframe core this whole slice is the first `@jini-ai/ui` consumer of. */
+export declare function createBrowserNewTabPreviewPort(): NewTabPreviewPort;
+export declare function createDefaultHtmlViewerDependencies(): HtmlViewerDependencies;
+export declare const defaultHtmlViewerDependencies: HtmlViewerDependencies;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/features/html-viewer/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../../src/features/html-viewer/dependencies.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5F,4GAA4G;AAC5G,wBAAgB,2BAA2B,IAAI,cAAc,CAuB5D;AAED,8JAA8J;AAC9J,wBAAgB,8BAA8B,IAAI,iBAAiB,CAMlE;AAED,wBAAgB,mCAAmC,IAAI,sBAAsB,CAK5E;AAOD,eAAO,MAAM,6BAA6B,EAAE,sBAA8D,CAAC"}

package/dist/features/html-viewer/dependencies.js

@@ -0,0 +1,51 @@
+import { openSandboxedPreviewInNewTab } from '@jini-ai/renderers-react';
+/** Real browser Fullscreen API binding. Every method is SSR-guarded (`typeof document === 'undefined'`). */
+export function createBrowserFullscreenPort() {
+    return {
+        async requestFullscreen(element) {
+            if (typeof element.requestFullscreen !== 'function')
+                return;
+            await element.requestFullscreen();
+        },
+        async exitFullscreen() {
+            if (typeof document === 'undefined')
+                return;
+            if (!document.fullscreenElement || typeof document.exitFullscreen !== 'function')
+                return;
+            await document.exitFullscreen();
+        },
+        fullscreenElement() {
+            // `?? null` rather than a bare pass-through: some DOM implementations
+            // (e.g. jsdom) leave `document.fullscreenElement` entirely undefined
+            // rather than defining it as a getter that returns `null`.
+            return typeof document === 'undefined' ? null : (document.fullscreenElement ?? null);
+        },
+        subscribeFullscreenChange(onChange) {
+            if (typeof document === 'undefined')
+                return () => { };
+            document.addEventListener('fullscreenchange', onChange);
+            return () => document.removeEventListener('fullscreenchange', onChange);
+        },
+    };
+}
+/** Reuses `@jini-ai/renderers-react`'s `openSandboxedPreviewInNewTab` — the sandboxed-iframe core this whole slice is the first `@jini-ai/ui` consumer of. */
+export function createBrowserNewTabPreviewPort() {
+    return {
+        openInNewTab(html, title) {
+            openSandboxedPreviewInNewTab(html, title);
+        },
+    };
+}
+export function createDefaultHtmlViewerDependencies() {
+    return {
+        fullscreen: createBrowserFullscreenPort(),
+        newTabPreview: createBrowserNewTabPreviewPort(),
+    };
+}
+// Module-level singleton default, matching `features/version-manager/`'s
+// `defaultVersionManagerDependencies` precedent: every wired hook binds to
+// this SAME instance rather than each independently constructing its own,
+// so two hooks in one tree that both omit `dependencies` still share state
+// (e.g. the fullscreen-change subscription).
+export const defaultHtmlViewerDependencies = createDefaultHtmlViewerDependencies();
+//# sourceMappingURL=dependencies.js.map

package/dist/features/html-viewer/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../../src/features/html-viewer/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAGxE,4GAA4G;AAC5G,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,KAAK,CAAC,iBAAiB,CAAC,OAAO;YAC7B,IAAI,OAAO,OAAO,CAAC,iBAAiB,KAAK,UAAU;gBAAE,OAAO;YAC5D,MAAM,OAAO,CAAC,iBAAiB,EAAE,CAAC;QACpC,CAAC;QACD,KAAK,CAAC,cAAc;YAClB,IAAI,OAAO,QAAQ,KAAK,WAAW;gBAAE,OAAO;YAC5C,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,OAAO,QAAQ,CAAC,cAAc,KAAK,UAAU;gBAAE,OAAO;YACzF,MAAM,QAAQ,CAAC,cAAc,EAAE,CAAC;QAClC,CAAC;QACD,iBAAiB;YACf,sEAAsE;YACtE,qEAAqE;YACrE,2DAA2D;YAC3D,OAAO,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,IAAI,IAAI,CAAC,CAAC;QACvF,CAAC;QACD,yBAAyB,CAAC,QAAQ;YAChC,IAAI,OAAO,QAAQ,KAAK,WAAW;gBAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;YACrD,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;YACxD,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;QAC1E,CAAC;KACF,CAAC;AACJ,CAAC;AAED,8JAA8J;AAC9J,MAAM,UAAU,8BAA8B;IAC5C,OAAO;QACL,YAAY,CAAC,IAAI,EAAE,KAAK;YACtB,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mCAAmC;IACjD,OAAO;QACL,UAAU,EAAE,2BAA2B,EAAE;QACzC,aAAa,EAAE,8BAA8B,EAAE;KAChD,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,2EAA2E;AAC3E,0EAA0E;AAC1E,2EAA2E;AAC3E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,6BAA6B,GAA2B,mCAAmC,EAAE,CAAC"}

package/dist/features/html-viewer/index.d.ts

@@ -0,0 +1,18 @@
+export type { DeckNavigateAction, DeckSlideState } from './types.js';
+export { DECK_NAVIGATE_MESSAGE_TYPE, DECK_STATE_MESSAGE_TYPE, DEFAULT_ZOOM, DEFAULT_ZOOM_LEVELS, } from './constants.js';
+export { canGoNext, canGoPrev, clampSlideIndex, isKnownZoomLevel, parseDeckStateMessage, slideCounterLabel, zoomToScale, } from './rules.js';
+export type { FullscreenPort, HtmlViewerDependencies, NewTabPreviewPort } from './ports.js';
+export { createBrowserFullscreenPort, createBrowserNewTabPreviewPort, createDefaultHtmlViewerDependencies, defaultHtmlViewerDependencies, } from './dependencies.js';
+export { useDeckNavigation } from './react/hooks/useDeckNavigation.js';
+export type { DeckNavigationController } from './react/hooks/useDeckNavigation.js';
+export { useZoomControl } from './react/hooks/useZoomControl.js';
+export type { ZoomController } from './react/hooks/useZoomControl.js';
+export { usePresentMode, useWiredPresentMode } from './react/hooks/usePresentMode.js';
+export type { PresentModeController } from './react/hooks/usePresentMode.js';
+export { DeckNavigationControls } from './react/components/DeckNavigationControls.js';
+export type { DeckNavigationControlsProps } from './react/components/DeckNavigationControls.js';
+export { ZoomMenu } from './react/components/ZoomMenu.js';
+export type { ZoomMenuProps } from './react/components/ZoomMenu.js';
+export { PresentMenu } from './react/components/PresentMenu.js';
+export type { PresentMenuProps } from './react/components/PresentMenu.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/html-viewer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/html-viewer/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EACT,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,mCAAmC,EACnC,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,YAAY,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtF,YAAY,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AACtF,YAAY,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/features/html-viewer/index.js

@@ -0,0 +1,10 @@
+export { DECK_NAVIGATE_MESSAGE_TYPE, DECK_STATE_MESSAGE_TYPE, DEFAULT_ZOOM, DEFAULT_ZOOM_LEVELS, } from './constants.js';
+export { canGoNext, canGoPrev, clampSlideIndex, isKnownZoomLevel, parseDeckStateMessage, slideCounterLabel, zoomToScale, } from './rules.js';
+export { createBrowserFullscreenPort, createBrowserNewTabPreviewPort, createDefaultHtmlViewerDependencies, defaultHtmlViewerDependencies, } from './dependencies.js';
+export { useDeckNavigation } from './react/hooks/useDeckNavigation.js';
+export { useZoomControl } from './react/hooks/useZoomControl.js';
+export { usePresentMode, useWiredPresentMode } from './react/hooks/usePresentMode.js';
+export { DeckNavigationControls } from './react/components/DeckNavigationControls.js';
+export { ZoomMenu } from './react/components/ZoomMenu.js';
+export { PresentMenu } from './react/components/PresentMenu.js';
+//# sourceMappingURL=index.js.map

package/dist/features/html-viewer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/html-viewer/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EACT,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,mCAAmC,EACnC,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAEtF,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/features/html-viewer/ports.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Browser APIs this slice needs directly: the Fullscreen API (for "present
+ * fullscreen") and opening a sandboxed preview in a new tab (for "present
+ * in new tab"). Both are genuine browser capabilities with no backend
+ * shape to fake — same reasoning `features/viewer-shell/`'s clipboard port
+ * and `features/version-manager/`'s reuse of it already document for this
+ * package.
+ */
+export interface FullscreenPort {
+    requestFullscreen(element: HTMLElement): Promise<void>;
+    exitFullscreen(): Promise<void>;
+    /** The element currently in fullscreen, or `null`. */
+    fullscreenElement(): Element | null;
+    /** Subscribe to fullscreen enter/exit (including the user pressing Escape, which this feature doesn't otherwise observe). Returns an unsubscribe function. */
+    subscribeFullscreenChange(onChange: () => void): () => void;
+}
+export interface NewTabPreviewPort {
+    /** Open `html` (already resolved to whatever the host wants rendered) in a new sandboxed tab, titled `title`. */
+    openInNewTab(html: string, title: string): void;
+}
+export interface HtmlViewerDependencies {
+    fullscreen: FullscreenPort;
+    newTabPreview: NewTabPreviewPort;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/features/html-viewer/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/features/html-viewer/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,sDAAsD;IACtD,iBAAiB,IAAI,OAAO,GAAG,IAAI,CAAC;IACpC,8JAA8J;IAC9J,yBAAyB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,iBAAiB;IAChC,iHAAiH;IACjH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,cAAc,CAAC;IAC3B,aAAa,EAAE,iBAAiB,CAAC;CAClC"}