@jini-ai/ui 0.1.0

package/dist/features/viewer-shell/react/hooks/useCopyToClipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopyToClipboard.js","sourceRoot":"","sources":["../../../../../src/features/viewer-shell/react/hooks/useCopyToClipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAQrE;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA8B,EAC9B,UAAkB,sBAAsB;IAExC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IAEpE,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI;gBAAE,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChE,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,IAAI,GAAG,WAAW,CACtB,KAAK,EAAE,IAAY,EAAoB,EAAE;QACvC,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,OAAO,EAAE,CAAC;YACZ,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI;gBAAE,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC9D,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,EACD,CAAC,SAAS,EAAE,OAAO,CAAC,CACrB,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,2EAA2E;AAC3E,yEAAyE;AACzE,4EAA4E;AAC5E,mEAAmE;AACnE,MAAM,sBAAsB,GAAwB,4BAA4B,EAAE,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO,kBAAkB,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC"}

package/dist/features/viewer-shell/react/hooks/useMarkdownScrollSync.d.ts

@@ -0,0 +1,32 @@
+import { type RefObject } from 'react';
+import type { MarkdownScrollPane, MarkdownSplitPaneMode } from '../../types.js';
+export interface UseMarkdownScrollSyncOptions {
+    mode: MarkdownSplitPaneMode;
+    sourceText: string;
+    editorRef: RefObject<HTMLTextAreaElement | null>;
+    previewRef: RefObject<HTMLElement | null>;
+    /** CSS selector for the rendered preview's root element inside
+     *  `previewRef.current`, forwarded to `measurePreviewBlockOffsets`. */
+    previewSelector?: string | undefined;
+    /** Bump this (e.g. pass the rendered HTML string) whenever the preview's
+     *  rendered content changes, so a resync runs even though `sourceText`
+     *  itself didn't move (matches the source's own `[html, mode]` effect
+     *  dependency). */
+    resyncKey?: unknown;
+}
+export interface UseMarkdownScrollSyncResult {
+    handleEditorScroll: () => void;
+    handlePreviewScroll: () => void;
+    activatePane: (pane: MarkdownScrollPane) => void;
+}
+/**
+ * Keeps a split editor/preview pane aligned while scrolling either side, by
+ * anchoring on each top-level markdown block's source line vs. its rendered
+ * DOM element (falling back to plain ratio-sync when block anchors can't be
+ * measured). This is the generic mechanism behind the source component's
+ * split-pane markdown viewer — ported without its artifact-status gate, its
+ * autosave/upload pipeline, and its shiki-based syntax highlighting (all
+ * genuinely OD/product-specific; see `packages/ui/source-map.md`).
+ */
+export declare function useMarkdownScrollSync(options: UseMarkdownScrollSyncOptions): UseMarkdownScrollSyncResult;
+//# sourceMappingURL=useMarkdownScrollSync.d.ts.map

package/dist/features/viewer-shell/react/hooks/useMarkdownScrollSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkdownScrollSync.d.ts","sourceRoot":"","sources":["../../../../../src/features/viewer-shell/react/hooks/useMarkdownScrollSync.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAOhF,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEhF,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,qBAAqB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACjD,UAAU,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC1C;2EACuE;IACvE,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;;;uBAGmB;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC,YAAY,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAClD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,2BAA2B,CAwJxG"}

package/dist/features/viewer-shell/react/hooks/useMarkdownScrollSync.js

@@ -0,0 +1,157 @@
+import { useCallback, useEffect, useMemo, useRef } from 'react';
+import { extractMarkdownBlockLines } from '../../../../utils/markdown-scroll-sync.js';
+import { computeSplitPaneScrollTarget, measureEditorBlockOffsets, measurePreviewBlockOffsets, } from '../../rules.js';
+/**
+ * Keeps a split editor/preview pane aligned while scrolling either side, by
+ * anchoring on each top-level markdown block's source line vs. its rendered
+ * DOM element (falling back to plain ratio-sync when block anchors can't be
+ * measured). This is the generic mechanism behind the source component's
+ * split-pane markdown viewer — ported without its artifact-status gate, its
+ * autosave/upload pipeline, and its shiki-based syntax highlighting (all
+ * genuinely OD/product-specific; see `packages/ui/source-map.md`).
+ */
+export function useMarkdownScrollSync(options) {
+    const { mode, sourceText, editorRef, previewRef, previewSelector, resyncKey } = options;
+    const editorBlockOffsetsRef = useRef(null);
+    const scrollSyncFrameRef = useRef(null);
+    const programmaticScrollClearFrameRef = useRef(null);
+    const pendingScrollSyncRef = useRef(null);
+    const programmaticScrollRef = useRef(null);
+    const activePaneRef = useRef('editor');
+    const blockLines = useMemo(() => extractMarkdownBlockLines(sourceText), [sourceText]);
+    useEffect(() => {
+        editorBlockOffsetsRef.current = null;
+    }, [sourceText]);
+    useEffect(() => {
+        return () => {
+            if (scrollSyncFrameRef.current !== null)
+                cancelAnimationFrame(scrollSyncFrameRef.current);
+            if (programmaticScrollClearFrameRef.current !== null)
+                cancelAnimationFrame(programmaticScrollClearFrameRef.current);
+        };
+    }, []);
+    const clearProgrammaticScrollSoon = useCallback(() => {
+        if (programmaticScrollClearFrameRef.current !== null) {
+            cancelAnimationFrame(programmaticScrollClearFrameRef.current);
+        }
+        programmaticScrollClearFrameRef.current = requestAnimationFrame(() => {
+            programmaticScrollClearFrameRef.current = requestAnimationFrame(() => {
+                programmaticScrollRef.current = null;
+                programmaticScrollClearFrameRef.current = null;
+            });
+        });
+    }, []);
+    const getEditorBlockOffsets = useCallback(() => {
+        const editor = editorRef.current;
+        if (!editor || blockLines.length === 0)
+            return null;
+        const width = editor.clientWidth;
+        const cached = editorBlockOffsetsRef.current;
+        if (cached && cached.width === width && cached.offsets.length === blockLines.length) {
+            return cached.offsets;
+        }
+        const offsets = measureEditorBlockOffsets(editor, blockLines, sourceText);
+        if (!offsets)
+            return null;
+        editorBlockOffsetsRef.current = { width, offsets };
+        return offsets;
+    }, [blockLines, editorRef, sourceText]);
+    const applyScrollSync = useCallback((sourcePane, targetPane) => {
+        const source = sourcePane === 'editor' ? editorRef.current : previewRef.current;
+        const target = targetPane === 'editor' ? editorRef.current : previewRef.current;
+        if (mode !== 'split' || !source || !target)
+            return;
+        const editorOffsets = getEditorBlockOffsets();
+        const previewOffsets = editorOffsets ? measurePreviewBlockOffsets(previewRef.current, blockLines.length, previewSelector) : null;
+        const targetTop = computeSplitPaneScrollTarget({
+            sourcePane,
+            source,
+            target,
+            blockLineCount: blockLines.length,
+            editorOffsets,
+            previewOffsets,
+        });
+        if (Math.abs(target.scrollTop - targetTop) < 1)
+            return;
+        programmaticScrollRef.current = { pane: targetPane, top: targetTop };
+        target.scrollTop = targetTop;
+        clearProgrammaticScrollSoon();
+    }, [blockLines.length, clearProgrammaticScrollSoon, editorRef, getEditorBlockOffsets, mode, previewRef, previewSelector]);
+    const scheduleScrollSync = useCallback((sourcePane, targetPane) => {
+        if (mode !== 'split') {
+            pendingScrollSyncRef.current = null;
+            return;
+        }
+        pendingScrollSyncRef.current = { sourcePane, targetPane };
+        if (scrollSyncFrameRef.current !== null)
+            return;
+        scrollSyncFrameRef.current = requestAnimationFrame(() => {
+            scrollSyncFrameRef.current = null;
+            // `pendingScrollSyncRef.current` is always non-null here: the only
+            // writers are this same callback's `{ sourcePane, targetPane }`
+            // assignment two lines above (which always runs immediately before
+            // a frame is requested) and the mode-effect's cleanup below, which
+            // nulls it out *together with* cancelling this very
+            // `scrollSyncFrameRef` frame via `cancelAnimationFrame` — so a
+            // cancelled frame's callback never actually runs to observe a null
+            // value. The non-null assertion exists only to satisfy
+            // TypeScript's `| null` ref type, not a real runtime path.
+            const pending = pendingScrollSyncRef.current;
+            pendingScrollSyncRef.current = null;
+            applyScrollSync(pending.sourcePane, pending.targetPane);
+        });
+    }, [applyScrollSync, mode]);
+    const shouldIgnoreScroll = useCallback((pane, element) => {
+        const programmatic = programmaticScrollRef.current;
+        if (programmatic?.pane !== pane)
+            return false;
+        if (Math.abs(element.scrollTop - programmatic.top) > 1 && activePaneRef.current === pane) {
+            return false;
+        }
+        programmaticScrollRef.current = null;
+        return true;
+    }, []);
+    const handleEditorScroll = useCallback(() => {
+        const editor = editorRef.current;
+        if (!editor || shouldIgnoreScroll('editor', editor))
+            return;
+        activePaneRef.current = 'editor';
+        scheduleScrollSync('editor', 'preview');
+    }, [editorRef, scheduleScrollSync, shouldIgnoreScroll]);
+    const handlePreviewScroll = useCallback(() => {
+        const previewPane = previewRef.current;
+        if (!previewPane || shouldIgnoreScroll('preview', previewPane))
+            return;
+        if (activePaneRef.current !== 'preview')
+            return;
+        scheduleScrollSync('preview', 'editor');
+    }, [previewRef, scheduleScrollSync, shouldIgnoreScroll]);
+    const activatePane = useCallback((pane) => {
+        activePaneRef.current = pane;
+    }, []);
+    useEffect(() => {
+        if (mode !== 'split') {
+            if (scrollSyncFrameRef.current !== null) {
+                cancelAnimationFrame(scrollSyncFrameRef.current);
+                scrollSyncFrameRef.current = null;
+            }
+            if (programmaticScrollClearFrameRef.current !== null) {
+                cancelAnimationFrame(programmaticScrollClearFrameRef.current);
+                programmaticScrollClearFrameRef.current = null;
+            }
+            pendingScrollSyncRef.current = null;
+            programmaticScrollRef.current = null;
+            activePaneRef.current = 'editor';
+            return;
+        }
+        // `activePaneRef.current` is a `MarkdownScrollPane` (never null/undefined
+        // — it's initialized to `'editor'` and every writer above assigns a real
+        // pane), so it's used directly rather than through a `??` fallback.
+        const sourcePane = activePaneRef.current;
+        const targetPane = sourcePane === 'preview' ? 'editor' : 'preview';
+        scheduleScrollSync(sourcePane, targetPane);
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- resyncKey intentionally re-triggers this on preview content changes.
+    }, [mode, resyncKey, scheduleScrollSync]);
+    return { handleEditorScroll, handlePreviewScroll, activatePane };
+}
+//# sourceMappingURL=useMarkdownScrollSync.js.map

package/dist/features/viewer-shell/react/hooks/useMarkdownScrollSync.js.map

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

package/dist/features/viewer-shell/rules.d.ts

@@ -0,0 +1,93 @@
+import { measureEditorBlockOffsets, measurePreviewBlockOffsets } from '../../utils/markdown-scroll-sync.js';
+import type { CommentSideDropEdge, MarkdownScrollPane, ViewerCommentBase } from './types.js';
+/** Human-readable file size (`"512 B"` / `"3.4 KB"` / `"1.2 MB"`). Ported
+ *  verbatim (no OD coupling in the original — a pure number formatter). */
+export declare function humanFileSize(bytes: number): string;
+/** Which edge of the drop target a pointer is over, based on the event's
+ *  vertical position relative to the target element's own bounding rect. */
+export declare function dropEdgeForClientY(clientY: number, targetRect: {
+    top: number;
+    height: number;
+}): CommentSideDropEdge;
+/** Recompute an ordered id list after dragging `draggingId` to sit
+ *  before/after `targetId`. Returns the original order unchanged if either
+ *  id is missing. */
+export declare function reorderCommentIds(ids: string[], draggingId: string, targetId: string, edge: CommentSideDropEdge): string[];
+/** Append a newly-saved comment id to a persisted order list, reconciling it
+ *  against the currently-visible comment ids first (drops ids that are no
+ *  longer visible, keeps visible ids not yet in the saved order). Returns the
+ *  same array reference when nothing actually changed. */
+export declare function appendSavedCommentOrder(currentOrderIds: string[], visibleIds: string[], savedId: string): string[];
+/** Default "just now / 5 minutes ago / 3 days ago" relative-time formatter.
+ *  Pure given a `now` timestamp — callers wrap the result in `t()` at the
+ *  call site (see the i18n policy in
+ *  `foundry/docs/jini-port/god-components-extraction-plan.md`). Returns a
+ *  `{ key, vars }` pair rather than a finished string so a host's `t()` can
+ *  supply its own plural/locale-aware phrasing; `key` is always one of a
+ *  small fixed set of English template strings. */
+export declare function relativeCommentTimeTranslation(timestampMs: number, nowMs?: number): {
+    key: string;
+    vars?: Record<string, number>;
+};
+/** Selection-count bookkeeping shared by the comment side-panel. */
+export declare function visibleSelectedCommentIds<TComment extends ViewerCommentBase>(comments: TComment[], selectedIds: ReadonlySet<string>): Set<string>;
+/** True when re-serializing `text` through `JSON.parse`/`JSON.stringify`
+ *  would silently change a number's printed form — e.g. `-0`, or a value
+ *  whose decimal digits round-trip differently once parsed into a JS
+ *  `number`. When true, callers should display the original text verbatim
+ *  instead of a "prettified" re-stringify. */
+export declare function hasPrecisionSensitiveJsonNumberText(text: string): boolean;
+/** True when `value` (already `JSON.parse`d) contains any non-finite number
+ *  or an integer outside `Number.isSafeInteger` range. */
+export declare function hasUnsafeJsonNumber(value: unknown): boolean;
+/**
+ * Pretty-print `text` as JSON when `isJsonLike` is true and doing so is
+ * provably safe (no precision loss) — otherwise returns `text` unchanged.
+ * `isJsonLike` is a plain boolean the caller derives from its own file-kind
+ * check (e.g. `file.name.endsWith('.json')`), not baked in here, since what
+ * counts as "this is a JSON file" is host-specific.
+ */
+export declare function formatJsonTextForDisplay(text: string, isJsonLike: boolean): string;
+/** Full scrollable range of `element` (0 when there's nothing to scroll). */
+export declare function scrollRange(element: {
+    scrollHeight: number;
+    clientHeight: number;
+}): number;
+/** `element`'s current scroll position as a 0..1 ratio of its scrollable
+ *  range (0 when there's nothing to scroll). */
+export declare function scrollRatio(element: {
+    scrollHeight: number;
+    clientHeight: number;
+    scrollTop: number;
+}): number;
+/** Inverse of {@link scrollRatio}: the scrollTop that puts `element` at
+ *  `ratio` (0..1, clamped) of its scrollable range. */
+export declare function scrollTopForRatio(element: {
+    scrollHeight: number;
+    clientHeight: number;
+}, ratio: number): number;
+/**
+ * Compute the target pane's scrollTop that keeps it aligned with the source
+ * pane, given the shared per-block line numbers (from
+ * `extractMarkdownBlockLines`, already ported to `../../utils/markdown-scroll-sync.js`).
+ * Falls back to plain ratio-sync when block-level anchors can't be measured
+ * (e.g. the rendered preview's direct-child count doesn't match the block
+ * count — see `measurePreviewBlockOffsets`'s own doc comment).
+ */
+export declare function computeSplitPaneScrollTarget(params: {
+    sourcePane: MarkdownScrollPane;
+    source: {
+        scrollTop: number;
+        scrollHeight: number;
+        clientHeight: number;
+    };
+    target: {
+        scrollHeight: number;
+        clientHeight: number;
+    };
+    blockLineCount: number;
+    editorOffsets: number[] | null;
+    previewOffsets: number[] | null;
+}): number;
+export { measureEditorBlockOffsets, measurePreviewBlockOffsets };
+//# sourceMappingURL=rules.d.ts.map

package/dist/features/viewer-shell/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/features/viewer-shell/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAM7F;2EAC2E;AAC3E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD;AAMD;4EAC4E;AAC5E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CAEpH;AAED;;qBAEqB;AACrB,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EAAE,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,mBAAmB,GACxB,MAAM,EAAE,CASV;AAED;;;0DAG0D;AAC1D,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,EAAE,EACzB,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,EAAE,MAAM,GACd,MAAM,EAAE,CAWV;AAED;;;;;;mDAMmD;AACnD,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,MAAmB,GACzB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAYhD;AAED,oEAAoE;AACpE,wBAAgB,yBAAyB,CAAC,QAAQ,SAAS,iBAAiB,EAC1E,QAAQ,EAAE,QAAQ,EAAE,EACpB,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAC/B,GAAG,CAAC,MAAM,CAAC,CAEb;AAMD;;;;8CAI8C;AAC9C,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAqCzE;AA+CD;0DAC0D;AAC1D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAO3D;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAUlF;AAMD,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE3F;AAED;gDACgD;AAChD,wBAAgB,WAAW,CAAC,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAG9G;AAED;uDACuD;AACvD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EACvD,KAAK,EAAE,MAAM,GACZ,MAAM,CAGR;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACjC,GAAG,MAAM,CAYT;AAED,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,CAAC"}

package/dist/features/viewer-shell/rules.js

@@ -0,0 +1,248 @@
+import { buildScrollAnchors, mapScrollPosition, measureEditorBlockOffsets, measurePreviewBlockOffsets, } from '../../utils/markdown-scroll-sync.js';
+// ---------------------------------------------------------------------------
+// Byte/size formatting
+// ---------------------------------------------------------------------------
+/** Human-readable file size (`"512 B"` / `"3.4 KB"` / `"1.2 MB"`). Ported
+ *  verbatim (no OD coupling in the original — a pure number formatter). */
+export function humanFileSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+// ---------------------------------------------------------------------------
+// Comment side-panel: drag-reorder + saved-order bookkeeping
+// ---------------------------------------------------------------------------
+/** Which edge of the drop target a pointer is over, based on the event's
+ *  vertical position relative to the target element's own bounding rect. */
+export function dropEdgeForClientY(clientY, targetRect) {
+    return clientY < targetRect.top + targetRect.height / 2 ? 'before' : 'after';
+}
+/** Recompute an ordered id list after dragging `draggingId` to sit
+ *  before/after `targetId`. Returns the original order unchanged if either
+ *  id is missing. */
+export function reorderCommentIds(ids, draggingId, targetId, edge) {
+    const next = [...ids];
+    const from = next.indexOf(draggingId);
+    if (from < 0)
+        return next;
+    const [draggedId] = next.splice(from, 1);
+    const targetIndex = next.indexOf(targetId);
+    if (targetIndex < 0 || !draggedId)
+        return ids;
+    next.splice(edge === 'after' ? targetIndex + 1 : targetIndex, 0, draggedId);
+    return next;
+}
+/** Append a newly-saved comment id to a persisted order list, reconciling it
+ *  against the currently-visible comment ids first (drops ids that are no
+ *  longer visible, keeps visible ids not yet in the saved order). Returns the
+ *  same array reference when nothing actually changed. */
+export function appendSavedCommentOrder(currentOrderIds, visibleIds, savedId) {
+    if (!savedId)
+        return currentOrderIds;
+    if (currentOrderIds.includes(savedId) || visibleIds.includes(savedId)) {
+        return currentOrderIds;
+    }
+    const visibleIdSet = new Set(visibleIds);
+    const kept = currentOrderIds.filter((id) => visibleIdSet.has(id));
+    const missingVisibleIds = visibleIds.filter((id) => !kept.includes(id));
+    const base = currentOrderIds.length > 0 ? [...kept, ...missingVisibleIds] : visibleIds;
+    const next = [...base, savedId];
+    return next.join('\0') === currentOrderIds.join('\0') ? currentOrderIds : next;
+}
+/** Default "just now / 5 minutes ago / 3 days ago" relative-time formatter.
+ *  Pure given a `now` timestamp — callers wrap the result in `t()` at the
+ *  call site (see the i18n policy in
+ *  `foundry/docs/jini-port/god-components-extraction-plan.md`). Returns a
+ *  `{ key, vars }` pair rather than a finished string so a host's `t()` can
+ *  supply its own plural/locale-aware phrasing; `key` is always one of a
+ *  small fixed set of English template strings. */
+export function relativeCommentTimeTranslation(timestampMs, nowMs = Date.now()) {
+    const diff = nowMs - timestampMs;
+    if (diff < 60_000)
+        return { key: 'Just now' };
+    const mins = Math.floor(diff / 60_000);
+    if (mins < 60)
+        return { key: '{n} minutes ago', vars: { n: mins } };
+    const hours = Math.floor(mins / 60);
+    if (hours < 24)
+        return { key: '{n} hours ago', vars: { n: hours } };
+    const days = Math.floor(hours / 24);
+    if (days < 7)
+        return { key: '{n} days ago', vars: { n: days } };
+    const weeks = Math.floor(days / 7);
+    if (weeks < 5)
+        return { key: '{n} weeks ago', vars: { n: weeks } };
+    return { key: new Date(timestampMs).toLocaleDateString() };
+}
+/** Selection-count bookkeeping shared by the comment side-panel. */
+export function visibleSelectedCommentIds(comments, selectedIds) {
+    return new Set(comments.filter((comment) => selectedIds.has(comment.id)).map((comment) => comment.id));
+}
+// ---------------------------------------------------------------------------
+// JSON-safe text formatting (used by a plain-text viewer body)
+// ---------------------------------------------------------------------------
+/** True when re-serializing `text` through `JSON.parse`/`JSON.stringify`
+ *  would silently change a number's printed form — e.g. `-0`, or a value
+ *  whose decimal digits round-trip differently once parsed into a JS
+ *  `number`. When true, callers should display the original text verbatim
+ *  instead of a "prettified" re-stringify. */
+export function hasPrecisionSensitiveJsonNumberText(text) {
+    let inString = false;
+    let escaped = false;
+    const numberTokenPattern = /-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?/y;
+    for (let i = 0; i < text.length;) {
+        const char = text[i];
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+            }
+            else if (char === '\\') {
+                escaped = true;
+            }
+            else if (char === '"') {
+                inString = false;
+            }
+            i += 1;
+            continue;
+        }
+        if (char === '"') {
+            inString = true;
+            i += 1;
+            continue;
+        }
+        numberTokenPattern.lastIndex = i;
+        const match = numberTokenPattern.exec(text);
+        if (!match) {
+            i += 1;
+            continue;
+        }
+        const token = match[0];
+        if (isSignedNegativeZeroJsonNumberToken(token))
+            return true;
+        if (/[.eE]/.test(token) && isPrecisionSensitiveJsonNumberToken(token))
+            return true;
+        i = numberTokenPattern.lastIndex;
+    }
+    return false;
+}
+function isSignedNegativeZeroJsonNumberToken(token) {
+    return /^-0(?:\.0+)?(?:[eE][+-]?\d+)?$/.test(token);
+}
+function isPrecisionSensitiveJsonNumberToken(token) {
+    const parsed = Number(token);
+    if (!Number.isFinite(parsed))
+        return true;
+    // `JSON.stringify` of a finite number always returns a non-empty numeral
+    // string ("0" at minimum) — there is no finite input for which it returns
+    // "" or another falsy value, so the defensive `!rendered` check this line
+    // replaces (present in the original source) could never actually fire.
+    const rendered = JSON.stringify(parsed);
+    const originalValue = parseJsonNumberTokenAsDecimal(token);
+    const renderedValue = parseJsonNumberTokenAsDecimal(rendered);
+    return originalValue.coefficient !== renderedValue.coefficient || originalValue.exponent !== renderedValue.exponent;
+}
+function parseJsonNumberTokenAsDecimal(token) {
+    // Both call sites above only ever pass a well-formed decimal/exponential
+    // JSON number literal: either a value matched by
+    // `hasPrecisionSensitiveJsonNumberText`'s own number-token regex (a strict
+    // subset of the pattern below — no leading zeros, always digits either
+    // side of `.`) or `JSON.stringify` output of a finite number (guaranteed
+    // by the JS spec to already be in this exact shape). So this match is
+    // guaranteed to succeed; the non-null assertion exists only to satisfy
+    // TypeScript's `RegExpExecArray | null` return type, not because there is
+    // a real runtime path where it fails.
+    const match = /^(-)?(\d+)(?:\.(\d+))?(?:[eE]([+-]?\d+))?$/.exec(token);
+    const [, sign, integerPart, fractionPart = '', exponentPart = '0'] = match;
+    const coefficient = BigInt(`${sign ?? ''}${integerPart}${fractionPart}`);
+    const exponent = Number(exponentPart) - fractionPart.length;
+    return normalizeDecimalParts(coefficient, exponent);
+}
+function normalizeDecimalParts(coefficient, exponent) {
+    if (coefficient === 0n)
+        return { coefficient: 0n, exponent: 0 };
+    let normalizedCoefficient = coefficient;
+    let normalizedExponent = exponent;
+    while (normalizedCoefficient % 10n === 0n) {
+        normalizedCoefficient /= 10n;
+        normalizedExponent += 1;
+    }
+    return { coefficient: normalizedCoefficient, exponent: normalizedExponent };
+}
+/** True when `value` (already `JSON.parse`d) contains any non-finite number
+ *  or an integer outside `Number.isSafeInteger` range. */
+export function hasUnsafeJsonNumber(value) {
+    if (typeof value === 'number') {
+        return !Number.isFinite(value) || (Number.isInteger(value) && !Number.isSafeInteger(value));
+    }
+    if (Array.isArray(value))
+        return value.some(hasUnsafeJsonNumber);
+    if (value && typeof value === 'object')
+        return Object.values(value).some(hasUnsafeJsonNumber);
+    return false;
+}
+/**
+ * Pretty-print `text` as JSON when `isJsonLike` is true and doing so is
+ * provably safe (no precision loss) — otherwise returns `text` unchanged.
+ * `isJsonLike` is a plain boolean the caller derives from its own file-kind
+ * check (e.g. `file.name.endsWith('.json')`), not baked in here, since what
+ * counts as "this is a JSON file" is host-specific.
+ */
+export function formatJsonTextForDisplay(text, isJsonLike) {
+    if (!isJsonLike)
+        return text;
+    try {
+        if (hasPrecisionSensitiveJsonNumberText(text))
+            return text;
+        const parsed = JSON.parse(text);
+        if (hasUnsafeJsonNumber(parsed))
+            return text;
+        return JSON.stringify(parsed, null, 2);
+    }
+    catch {
+        return text;
+    }
+}
+// ---------------------------------------------------------------------------
+// Split source/preview pane scroll-sync
+// ---------------------------------------------------------------------------
+/** Full scrollable range of `element` (0 when there's nothing to scroll). */
+export function scrollRange(element) {
+    return Math.max(0, element.scrollHeight - element.clientHeight);
+}
+/** `element`'s current scroll position as a 0..1 ratio of its scrollable
+ *  range (0 when there's nothing to scroll). */
+export function scrollRatio(element) {
+    const range = scrollRange(element);
+    return range > 0 ? element.scrollTop / range : 0;
+}
+/** Inverse of {@link scrollRatio}: the scrollTop that puts `element` at
+ *  `ratio` (0..1, clamped) of its scrollable range. */
+export function scrollTopForRatio(element, ratio) {
+    const clamped = Math.max(0, Math.min(1, Number.isFinite(ratio) ? ratio : 0));
+    return scrollRange(element) * clamped;
+}
+/**
+ * Compute the target pane's scrollTop that keeps it aligned with the source
+ * pane, given the shared per-block line numbers (from
+ * `extractMarkdownBlockLines`, already ported to `../../utils/markdown-scroll-sync.js`).
+ * Falls back to plain ratio-sync when block-level anchors can't be measured
+ * (e.g. the rendered preview's direct-child count doesn't match the block
+ * count — see `measurePreviewBlockOffsets`'s own doc comment).
+ */
+export function computeSplitPaneScrollTarget(params) {
+    const { sourcePane, source, target, blockLineCount, editorOffsets, previewOffsets } = params;
+    if (blockLineCount > 0 && editorOffsets && previewOffsets) {
+        const isEditorSource = sourcePane === 'editor';
+        const sourceOffsets = isEditorSource ? editorOffsets : previewOffsets;
+        const targetOffsets = isEditorSource ? previewOffsets : editorOffsets;
+        const sourceAnchors = buildScrollAnchors(sourceOffsets, source.scrollHeight);
+        const targetAnchors = buildScrollAnchors(targetOffsets, target.scrollHeight);
+        const mapped = mapScrollPosition(source.scrollTop, sourceAnchors, targetAnchors);
+        return Math.max(0, Math.min(scrollRange(target), mapped));
+    }
+    return scrollTopForRatio(target, scrollRatio(source));
+}
+export { measureEditorBlockOffsets, measurePreviewBlockOffsets };
+//# sourceMappingURL=rules.js.map

package/dist/features/viewer-shell/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/features/viewer-shell/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,qCAAqC,CAAC;AAG7C,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;2EAC2E;AAC3E,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AAClD,CAAC;AAED,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E;4EAC4E;AAC5E,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,UAA2C;IAC7F,OAAO,OAAO,GAAG,UAAU,CAAC,GAAG,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/E,CAAC;AAED;;qBAEqB;AACrB,MAAM,UAAU,iBAAiB,CAC/B,GAAa,EACb,UAAkB,EAClB,QAAgB,EAChB,IAAyB;IAEzB,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IACtB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,WAAW,GAAG,CAAC,IAAI,CAAC,SAAS;QAAE,OAAO,GAAG,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5E,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;0DAG0D;AAC1D,MAAM,UAAU,uBAAuB,CACrC,eAAyB,EACzB,UAAoB,EACpB,OAAe;IAEf,IAAI,CAAC,OAAO;QAAE,OAAO,eAAe,CAAC;IACrC,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,iBAAiB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IACvF,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC;AACjF,CAAC;AAED;;;;;;mDAMmD;AACnD,MAAM,UAAU,8BAA8B,CAC5C,WAAmB,EACnB,QAAgB,IAAI,CAAC,GAAG,EAAE;IAE1B,MAAM,IAAI,GAAG,KAAK,GAAG,WAAW,CAAC;IACjC,IAAI,IAAI,GAAG,MAAM;QAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;IACvC,IAAI,IAAI,GAAG,EAAE;QAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;IACpE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACpC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACpC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IACnC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;IACnE,OAAO,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,kBAAkB,EAAE,EAAE,CAAC;AAC7D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,yBAAyB,CACvC,QAAoB,EACpB,WAAgC;IAEhC,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AACzG,CAAC;AAED,8EAA8E;AAC9E,+DAA+D;AAC/D,8EAA8E;AAE9E;;;;8CAI8C;AAC9C,MAAM,UAAU,mCAAmC,CAAC,IAAY;IAC9D,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,kBAAkB,GAAG,8CAA8C,CAAC;IAC1E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAI,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;iBAAM,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBACzB,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;iBAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACxB,QAAQ,GAAG,KAAK,CAAC;YACnB,CAAC;YACD,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,QAAQ,GAAG,IAAI,CAAC;YAChB,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QAED,kBAAkB,CAAC,SAAS,GAAG,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,mCAAmC,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5D,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,mCAAmC,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnF,CAAC,GAAG,kBAAkB,CAAC,SAAS,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mCAAmC,CAAC,KAAa;IACxD,OAAO,gCAAgC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,mCAAmC,CAAC,KAAa;IACxD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,yEAAyE;IACzE,0EAA0E;IAC1E,0EAA0E;IAC1E,uEAAuE;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,aAAa,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,6BAA6B,CAAC,QAAQ,CAAC,CAAC;IAC9D,OAAO,aAAa,CAAC,WAAW,KAAK,aAAa,CAAC,WAAW,IAAI,aAAa,CAAC,QAAQ,KAAK,aAAa,CAAC,QAAQ,CAAC;AACtH,CAAC;AAED,SAAS,6BAA6B,CAAC,KAAa;IAClD,yEAAyE;IACzE,iDAAiD;IACjD,2EAA2E;IAC3E,uEAAuE;IACvE,yEAAyE;IACzE,sEAAsE;IACtE,uEAAuE;IACvE,0EAA0E;IAC1E,sCAAsC;IACtC,MAAM,KAAK,GAAG,4CAA4C,CAAC,IAAI,CAAC,KAAK,CAAE,CAAC;IACxE,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,GAAG,EAAE,EAAE,YAAY,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;IAC3E,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,GAAG,WAAW,GAAG,YAAY,EAAE,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC;IAC5D,OAAO,qBAAqB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,qBAAqB,CAAC,WAAmB,EAAE,QAAgB;IAClE,IAAI,WAAW,KAAK,EAAE;QAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAChE,IAAI,qBAAqB,GAAG,WAAW,CAAC;IACxC,IAAI,kBAAkB,GAAG,QAAQ,CAAC;IAClC,OAAO,qBAAqB,GAAG,GAAG,KAAK,EAAE,EAAE,CAAC;QAC1C,qBAAqB,IAAI,GAAG,CAAC;QAC7B,kBAAkB,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;AAC9E,CAAC;AAED;0DAC0D;AAC1D,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACjE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC9F,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,UAAmB;IACxE,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,mCAAmC,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;QAC3C,IAAI,mBAAmB,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,wCAAwC;AACxC,8EAA8E;AAE9E,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,OAAuD;IACjF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAClE,CAAC;AAED;gDACgD;AAChD,MAAM,UAAU,WAAW,CAAC,OAA0E;IACpG,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;uDACuD;AACvD,MAAM,UAAU,iBAAiB,CAC/B,OAAuD,EACvD,KAAa;IAEb,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,OAAO,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AACxC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAO5C;IACC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAC7F,IAAI,cAAc,GAAG,CAAC,IAAI,aAAa,IAAI,cAAc,EAAE,CAAC;QAC1D,MAAM,cAAc,GAAG,UAAU,KAAK,QAAQ,CAAC;QAC/C,MAAM,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC;QACtE,MAAM,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;QACtE,MAAM,aAAa,GAAG,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAC7E,MAAM,aAAa,GAAG,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;QACjF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,CAAC"}