@wafertools/wafermap 0.21.1

package/dist/packages/canvas-adapter/toolbar.d.ts

@@ -0,0 +1,496 @@
+import type { PlotMode } from '../renderer/buildView.js';
+import type { Die } from '../core/dies.js';
+import type { TestDef, MetadataFieldDef } from '../renderer/buildWaferMap.js';
+import type { StatsSeverity } from '../stats/types.js';
+export declare function logWmapVersionOnce(): void;
+export declare const WMAP_TOKEN_NAMES: readonly ["z", "icon", "icon-hover", "icon-active", "bg-hover", "bg-active", "separator", "surface", "border", "menu-hover", "menu-active", "panel-bg", "text-muted", "text", "text-strong", "warn-bg", "warn-border", "warn-text", "info-bg", "info-text", "selected", "finding-indicator", "canvas-bg"];
+export type WmapTokenName = (typeof WMAP_TOKEN_NAMES)[number];
+export declare const CLR: {
+    icon: string;
+    iconHover: string;
+    iconActive: string;
+    bgHover: string;
+    bgActive: string;
+    separator: string;
+    menuBg: string;
+    menuBorder: string;
+    menuHover: string;
+    menuActive: string;
+    panelBg: string;
+    label: string;
+    value: string;
+    text: string;
+    warnBg: string;
+    warnBorder: string;
+    warnText: string;
+    infoBg: string;
+    infoText: string;
+    findingHighlight: string;
+    findingIndicator: string;
+};
+/**
+ * Findings-severity → colour, shared by summaryPanel.ts (severity dots/borders
+ * on the findings list) and renderWaferGallery.ts (its own copy drifted from
+ * this one only by name, never by value — hoisted here so the two can't
+ * silently diverge again).
+ */
+export declare function sevColor(s: StatsSeverity): string;
+export declare const ROTATIONS: Array<0 | 90 | 180 | 270>;
+export declare const INLINE_TEST_LIMIT = 6;
+/** Above this many rows, a scrollable list (test cascade submenu, chart test picker) gets a filter box. */
+export declare const MENU_SEARCH_THRESHOLD = 8;
+export declare const DEFAULT_OVERLAY_Z = 6000;
+/** `z-index` value string for a base-level overlay (menus, modal backdrop). */
+export declare const Z_BASE = "var(--wmap-z, 6000)";
+/** One above base — tooltips, submenus, the modal box above its backdrop. */
+export declare const Z_ABOVE = "calc(var(--wmap-z, 6000) + 1)";
+/** Two above base — controls that must sit above a maximized modal box. */
+export declare const Z_ABOVE2 = "calc(var(--wmap-z, 6000) + 2)";
+/**
+ * Apply a host-supplied `zIndex` to wmap's overlays by writing `--wmap-z` onto
+ * `document.documentElement`. Returns a disposer that restores the previous
+ * value (called on controller `destroy`). No-op when `zIndex` is undefined, so
+ * the safe high default in `Z_BASE`/`Z_ABOVE` applies.
+ *
+ * `--wmap-z` is set on the document root (not the render container) because
+ * several overlays append to `document.body`, outside the container's subtree,
+ * and must still inherit the value.
+ */
+export declare function applyOverlayZ(zIndex: number | undefined): () => void;
+/** Copy every `--wmap-*` custom property resolved on `src` onto `dest`, so an
+ * element in a different document (e.g. a detached popup's `documentElement`)
+ * renders with the same theme as the host page instead of silently reverting
+ * to light-mode defaults. */
+export declare function copyWmapThemeTokens(src: Element, dest: HTMLElement): void;
+/**
+ * Keeps a popup's copied `--wmap-*` tokens (`copyWmapThemeTokens`, above) in
+ * sync with *later* host theme changes. A one-time copy at open time is a
+ * snapshot, not a live link (CSS custom properties can't inherit across
+ * documents) — if the host flips theme while the popup is still open (e.g. a
+ * dark-mode toggle re-pointing its `--wmap-*` values), nothing would
+ * otherwise re-copy them. Watches attribute changes on `themeSource` and
+ * `<html>` — the two most common places a host actually changes theme (a
+ * toggled class or inline style) — plus the OS light/dark preference. This
+ * can't observe a change on some other ancestor further up that isn't
+ * `themeSource` or `<html>` itself, but that already covers the realistic
+ * cases; watching the whole ancestor chain generically is not something
+ * anything else in this codebase does either. `onResync`, if given, fires
+ * alongside each re-copy — e.g. to force a live map inside the popup to
+ * redraw so its canvas re-resolves the same palette (CSS custom properties
+ * update DOM-driven chrome automatically, but a canvas only re-resolves
+ * `--wmap-*` at its next draw). Returns a disposer to call when the popup closes.
+ */
+export declare function syncWmapPopupTheme(themeSource: Element, popupDocumentElement: HTMLElement, onResync?: () => void): () => void;
+export type DetachWindowOpener = (label: string) => Window | null;
+/** Register a custom opener for gallery card detach windows — e.g. one backed
+ * by a Tauri `WebviewWindow`, for hosts where `window.open` is blocked. The
+ * opener receives the card's label and must return a `Window`-like handle
+ * (with a usable `.document`) to build into, or `null` to decline (treated
+ * exactly like a blocked popup — the detach silently no-ops). */
+export declare function setDetachWindowOpener(opener: DetachWindowOpener | null): void;
+/** Open a blank window for a detached gallery card. Uses the registered
+ * `setDetachWindowOpener` opener when present, else falls back to a plain
+ * `window.open` popup.
+ *
+ * Known cosmetic quirk: since this never navigates away from `about:blank`,
+ * Chrome's window-title algorithm shows "{title} - Chrome" in the OS window/
+ * tab title instead of just the title we set (an un-navigated about:blank
+ * window is treated as titleless regardless of `document.title`). Navigating
+ * to a real URL would fix it but means either re-running the host page's own
+ * script inside the popup (real risk of double side effects) or requiring a
+ * dedicated blank same-origin asset — not worth it for a cosmetic issue. */
+export declare function openDetachWindow(label: string): Window | null;
+export declare const MODE_LABELS: Record<PlotMode, string>;
+export declare const BIN_LEGEND_MODES: Set<PlotMode>;
+export declare const STACKED_MODES: Set<PlotMode>;
+/**
+ * Host hook for persisting a rendered PNG. When supplied, the toolbar calls this
+ * instead of triggering a browser `<a download>`, letting embedded hosts (Tauri,
+ * Electron, WebView2) route the blob through a native save dialog or upload.
+ * Receives the PNG `blob` and a `suggestedName` (already includes `.png`).
+ */
+export type SaveImageHandler = (blob: Blob, suggestedName: string) => void | Promise<void>;
+/**
+ * Persist a rendered PNG blob. Routes through the host `onSaveImage` hook when
+ * provided; otherwise falls back to a browser `<a download>` click. Single
+ * source of truth for the save action across `renderWaferMap` and
+ * `renderWaferGallery` — neither should reimplement the `<a download>` dance.
+ *
+ * @param blob          the PNG blob (e.g. from `canvas.toBlob`)
+ * @param filename      filename without extension (e.g. `'wafermap'`)
+ * @param onSaveImage   optional host hook; when present, bypasses `<a download>`
+ */
+export declare function saveImageBlob(blob: Blob, filename: string, onSaveImage?: SaveImageHandler): void;
+/**
+ * Host hook for saving a text file (CSV, etc). Mirrors `SaveImageHandler` —
+ * when provided, `saveTextFile` calls this instead of triggering a browser
+ * `<a download>`, letting embedded hosts (Tauri, Electron, WebView2) route
+ * the text through a native save dialog. Receives the raw `text`, a
+ * `suggestedName` (already includes its extension), and the `mimeType`.
+ */
+export type SaveTextHandler = (text: string, suggestedName: string, mimeType: string) => void | Promise<void>;
+/**
+ * Persist a text file (e.g. a CSV export). Routes through the host
+ * `onSaveText` hook when provided; otherwise falls back to a browser
+ * `<a download>` click — the same `<a download>` dance `saveImageBlob` uses
+ * for PNG saves, which is silently a no-op in Tauri/Electron/WebView2 (see
+ * `saveImageBlob`'s own doc comment), hence the hook.
+ *
+ * @param text        the file contents
+ * @param filename    filename including extension (e.g. `'test-values.csv'`)
+ * @param mimeType    e.g. `'text/csv'`
+ * @param onSaveText  optional host hook; when present, bypasses `<a download>`
+ */
+export declare function saveTextFile(text: string, filename: string, mimeType: string, onSaveText?: SaveTextHandler): void;
+/**
+ * Run `fn` on the next animation frame, falling back to a macrotask in
+ * environments without `requestAnimationFrame` (e.g. JSDOM under tests).
+ * Used to defer focus moves until the element is laid out, and to schedule
+ * re-renders after a resize.
+ *
+ * Accepts an explicit `ownerWindow` — a bare `requestAnimationFrame` reference
+ * resolves to whichever window this MODULE was first evaluated in (the host
+ * page's), not necessarily the window whose layout the caller actually cares
+ * about. For a gallery card detached into its own popup window, scheduling
+ * against the opener's rAF loop means the callback only fires when the OPENER
+ * repaints (e.g. on mouse movement there) — not when the popup itself does,
+ * which reads as "the map doesn't resize until I move focus back to the main
+ * window." Passing the popup's own `window` fixes this.
+ */
+export declare function nextFrame(fn: () => void, ownerWindow?: Window): void;
+export declare function overlayRootFor(anchor: Element): Element;
+/** The shared tooltip element for `doc` (default: the host page's own
+ * document), lazily created and appended to `doc.body`. */
+export declare function getTooltip(doc?: Document): HTMLDivElement;
+/** Hide `doc`'s shared tooltip. Deliberately does NOT re-home it to `doc.body`
+ * — it stays wherever `reparentTooltip()` last placed it (e.g. inside an open
+ * floating window's box). A non-modal floating window can stay open for many
+ * ordinary hover/unhover cycles; snapping the tooltip back to `<body>` on
+ * every hide (as this used to do) meant the very first unhover after opening
+ * a floating window silently evicted the tooltip from the window's stacking
+ * context, and it was never reparented back in — every subsequent hover in
+ * that window then rendered the tooltip at `<body>`'s z-index, BEHIND the
+ * window. Callers that actually close an overlay (see `openOverlay`'s
+ * `close()`) are responsible for reparenting the tooltip back to `<body>`
+ * themselves once the box that owned it is really going away. */
+export declare function hideTooltip(doc?: Document): void;
+/**
+ * Move `parent`'s document's shared tooltip into `parent` (e.g. a maximized
+ * modal box that creates its own stacking/overflow context). Pass nothing to
+ * re-home the host page's tooltip to `document.body`.
+ */
+export declare function reparentTooltip(parent?: HTMLElement): void;
+/**
+ * Position the shared tooltip near (clientX, clientY), re-homing it under
+ * `anchor`'s nearest overlay root first (see overlayRootFor) if it isn't there
+ * already. Re-resolving on every call is deliberate and cheap (a short
+ * ancestor walk) — anchor's overlay root can change over the tooltip's
+ * lifetime (e.g. a host opens its own <dialog> around an already-rendered
+ * map), and the `parentElement !==` guard means the DOM is only actually
+ * touched when the root has changed, not on every mousemove.
+ */
+export declare function positionTooltip(tooltip: HTMLDivElement, anchor: Element, clientX: number, clientY: number): void;
+export interface ToolbarHelpers {
+    makeBtn(iconKey: string, label: string, onClick: () => void): HTMLButtonElement;
+    setActive(btn: HTMLButtonElement, active: boolean): void;
+    makeSep(): HTMLDivElement;
+    makeMenuRow(label: string, active: boolean, indent: boolean, onClick: (e: MouseEvent) => void): HTMLDivElement;
+    makeMenuSection(label: string): HTMLDivElement;
+    makeDropdown<T extends string>(iconKey: string, title: string, getItems: () => Array<{
+        value: T;
+        label: string;
+    }>, getCurrent: () => T, onPick: (v: T) => void): HTMLButtonElement;
+    /**
+     * Create a button that opens a persistent checkbox-style dropdown menu.
+     * `getRows` is called fresh on each open/replace so active state is always current.
+     * `onSync` is called after each row click to update the button's active highlight.
+     */
+    makeCheckMenuBtn(iconKey: string, label: string, getRows: () => CheckMenuRow[], onSync: (btn: HTMLButtonElement) => void): HTMLButtonElement;
+    closeOpenMenu(e: MouseEvent): void;
+    /** Read/write the shared open-menu slot — used by custom menus that can't go through makeDropdown. */
+    getOpenMenu(): HTMLDivElement | null;
+    setOpenMenu(menu: HTMLDivElement | null): void;
+}
+export type ModeEntry = {
+    plotMode: PlotMode;
+    activeTest?: number;
+    activeMetadataKey?: string;
+    label: string;
+    logScale?: boolean;
+};
+/**
+ * Which plot modes the data actually supports — the single derivation shared by
+ * `renderWaferMap` and `renderWaferGallery`.
+ *
+ * This is a correctness surface, not a convenience: the library's rule is that UI
+ * controls must derive validity from the data the library built, never from a
+ * caller-supplied flag. Two copies of that derivation can silently disagree about
+ * which modes are offered (and adding a new plot mode means remembering both),
+ * so it lives here with the rest of the shared toolbar primitives.
+ *
+ * `includeStacked` is the one genuine difference between the two callers, and is
+ * a deliberate parameter rather than an inferred value: stacked modes are valid
+ * for `renderWaferMap` only when the result was built from a `lotStack`
+ * (`view.isLotStack`), whereas `renderWaferGallery` aggregates across its own
+ * items and can always offer them.
+ */
+export declare function buildDataModeEntries(dies: Die[], testDefs: TestDef[] | undefined, options: {
+    includeStacked: boolean;
+}): {
+    testEntries: ModeEntry[];
+    binEntries: ModeEntry[];
+    stackedEntries: ModeEntry[];
+};
+/**
+ * True when at least one die actually carries a value for this metadata key.
+ * Presence in `metadataFields` is an opt-in declaration; this is the "and there
+ * is data for it" half of the same check, shared so the single map and the
+ * gallery can't disagree on which fields to offer.
+ */
+export declare function metadataKeyHasData(dies: Die[], key: string): boolean;
+/** A configured metadata field → its mode-menu entry, with the shared label fallback. */
+export declare function metadataModeEntry(field: MetadataFieldDef): ModeEntry;
+/**
+ * A text input for filtering a list of rows by their label text, meant to sit
+ * at the top of a scrollable menu/list once it gets long enough that scanning
+ * beats scrolling. Shared by the plot-mode test-value cascade submenu here and
+ * the chart test picker (`chartShell.ts`'s `makeSearchableTestSelect`) so both
+ * get the same filter-as-you-type box instead of building it twice.
+ *
+ * `onFilter` receives the lowercased query on every keystroke; the caller
+ * owns showing/hiding its own rows. Autofocuses on mount. Click/keydown are
+ * stopped from bubbling so typing (including Space/arrow keys) lands in the
+ * input rather than triggering the host menu's own keyboard navigation.
+ */
+export declare function makeMenuSearchBox(onFilter: (query: string) => void, placeholder?: string): HTMLInputElement;
+/**
+ * Build the plot-mode dropdown menu element.
+ * Shared between renderWaferMap and renderWaferGallery.
+ * The caller provides data-derived entry arrays and pick/active callbacks.
+ */
+export declare function buildModeMenuEl(anchorRect: DOMRect, testEntries: ModeEntry[], binEntries: ModeEntry[], stackedEntries: ModeEntry[], isCurrentEntry: (e: ModeEntry) => boolean, pickEntry: (entry: ModeEntry, menu: HTMLElement) => void, helpers: Pick<ToolbarHelpers, 'makeMenuRow' | 'makeMenuSection'>, currentMode: PlotMode, ownerWindow?: Window, metadataEntries?: ModeEntry[]): HTMLDivElement;
+/**
+ * Mark a button as a menu trigger and reflect its open/closed state. Call with
+ * `expanded` on open/close so assistive tech announces the popup state. Public
+ * so the adapters can apply it to mode-menu triggers they mount themselves.
+ */
+export declare function markMenuTrigger(btn: HTMLElement, expanded: boolean): void;
+/**
+ * Public re-export of the internal roving-focus keyboard wiring, for menus the
+ * adapters mount directly (the plot-mode menu). See `wireMenuKeyboard`.
+ */
+export declare function wireMenuA11y(menu: HTMLElement, trigger: HTMLElement | null, close: () => void): void;
+export interface ExpandToggleHandle {
+    isOpen(): boolean;
+    /** Force-close without toggling — used for e.g. a data refresh that should collapse an open panel. */
+    close(): void;
+    destroy(): void;
+}
+/**
+ * Shared "click/Enter/Space toggles an expand/collapse state, Escape or an
+ * outside click closes it" wiring — the small interaction pattern behind both
+ * the metadata badge's own expand (metadataBadge.ts) and the gallery card
+ * header's metadata reveal (renderWaferGallery.ts). `trigger` gets
+ * `role="button"`/`tabindex` and the event listeners; `onChange(open)` is
+ * called whenever the state actually changes (never redundantly) — the
+ * caller owns all the resulting DOM (aria-expanded text, panel visibility,
+ * content), this only owns the open/closed boolean and its triggers.
+ */
+export declare function wireExpandToggle(trigger: HTMLElement, onChange: (open: boolean) => void): ExpandToggleHandle;
+export type CheckMenuRow = {
+    section: string;
+} | {
+    label: string;
+    active: boolean;
+    enabled?: boolean;
+    onClick: (e: MouseEvent) => void;
+};
+/**
+ * Build a checkbox-style dropdown menu (for overlays/orientation groups).
+ * Each row with an `onClick` is a toggleable item; rows with `section` are headers.
+ * Stays open after each click so the user can toggle multiple items.
+ */
+export declare function buildCheckMenuEl(anchorRect: DOMRect, rows: CheckMenuRow[], helpers: Pick<ToolbarHelpers, 'makeMenuRow' | 'makeMenuSection'>, ownerWindow?: Window): HTMLDivElement;
+export declare function createToolbarHelpers(tooltip: HTMLDivElement): ToolbarHelpers;
+export type OverlayMode = 'modal' | 'window';
+export interface OverlayOptions {
+    /** Optional title shown in the header left. */
+    title?: string;
+    mode: OverlayMode;
+    /**
+     * Called when the maximized state changes — use to reparent tooltips etc. Uses
+     * a CSS maximize (the box grows to fill its backdrop/the viewport), not the
+     * real Fullscreen API, for macOS WKWebView compatibility.
+     */
+    onMaximizeChange?: (isMaximized: boolean, box: HTMLElement) => void;
+    /** Called when the overlay is closed. */
+    onClose: () => void;
+    /**
+     * The document to build this overlay into — defaults to the bare global
+     * `document`. Pass the triggering element's `ownerDocument` when the
+     * caller's own container might live in a different document (e.g.
+     * `renderWaferMap`'s own expand modal, whose canvas could be inside a
+     * gallery card detached into its own popup window) — otherwise the overlay
+     * silently builds into the WRONG document, visibly emptying the popup and
+     * popping the box up on the host page instead.
+     */
+    ownerDocument?: Document;
+    /**
+     * An element from the triggering render's own live DOM subtree — used to
+     * resolve the overlay's root via `overlayRootFor` instead of always
+     * `doc.body`. Needed so this overlay itself (not just the tooltip/menus)
+     * lands inside a host's own native `<dialog>` (shown via `.showModal()`,
+     * which promotes it into the browser's top layer — see `overlayRootFor`'s
+     * own doc comment) when the map is embedded inside one; without it, the
+     * modal/window box would build straight onto `doc.body`, which sits BEHIND
+     * that top-layer dialog regardless of z-index. Any still-attached element
+     * from the render works equally well — the exact choice doesn't matter,
+     * only that it lives in the correct subtree at call time. Omit when no
+     * such element exists (e.g. a click handler with no natural anchor); the
+     * overlay then falls back to `doc.body`, matching prior behaviour exactly.
+     */
+    anchor?: Element;
+}
+export interface OverlayHandle {
+    /** null in 'window' mode — there is no backdrop to block the page. */
+    backdrop: HTMLDivElement | null;
+    box: HTMLDivElement;
+    /** Flex container inside the box for the canvas/content area. */
+    contentWrap: HTMLDivElement;
+    /** Close the overlay — removes DOM, restores scroll, removes all listeners, fires onClose. */
+    close: () => void;
+    /** Raise this window above other open windows. No-op in 'modal' mode. */
+    bringToFront: () => void;
+}
+/** Create and open a resizable, maximizable, exclusive expand modal — dims and
+ * blocks the rest of the page. See `openFloatingWindow` for the non-modal form. */
+export declare function openModal(opts: Omit<OverlayOptions, 'mode'>): OverlayHandle;
+/** Create and open a resizable, maximizable, non-modal floating window — the
+ * rest of the page stays fully interactive, and multiple windows may be open at
+ * once. See `openModal` for the exclusive/blocking form. */
+export declare function openFloatingWindow(opts: Omit<OverlayOptions, 'mode'>): OverlayHandle;
+export interface ReparentModalOptions {
+    ownerDocument?: Document;
+    title?: string;
+    /** Called after the modal has closed and every element has been restored to its original position (or appended back, if its original spot is no longer available — see the stale-reference note above). Runs once, even if nothing was actually moved (the re-entrancy guard tripped). */
+    onClosed?: () => void;
+}
+/**
+ * Reparent one or more elements (moved together, in the given order) into a
+ * new modal's `contentWrap`, and restore each to its original position when
+ * the modal closes. Returns `null` — opening nothing — if any element is
+ * already inside a still-open modal from an earlier call; the caller's own
+ * trigger should normally be hidden/disabled for that duration anyway (see
+ * both call sites), this is defense in depth, not the primary guard.
+ */
+export declare function openReparentedModal(elements: HTMLElement[], opts?: ReparentModalOptions): OverlayHandle | null;
+/**
+ * `sync()` hides the button entirely in `'metadata'` mode — that mode never
+ * consults `colorFns`/the active colour scheme at all (always the dedicated
+ * ordered palette + `MetadataFieldDef.values[].color` overrides, see
+ * `pushDieRectangles`), so every scheme choice would be a real control with
+ * zero visible effect, not just a restricted one — worse than the existing
+ * hardBin/softBin restriction (which still changes the die colours, just from
+ * a smaller scheme set).
+ */
+export declare function makePaletteBtn(helpers: ToolbarHelpers, getPlotMode: () => PlotMode, getColorScheme: () => string, hasCustomColors: () => boolean, setColorScheme: (v: string) => void): {
+    btn: HTMLButtonElement;
+    sync: () => void;
+};
+/** Requested pass/fail display, defaulting to 'off' when unset. */
+export declare function requestedPassFailDisplay(opts: {
+    passFailDisplay?: 'off' | 'spec' | 'test';
+}): 'off' | 'spec' | 'test';
+/**
+ * The two mutually exclusive pass/fail display entries for the overlays menu,
+ * shared by renderWaferMap and renderWaferGallery. Each entry appears only when
+ * valid for the active test (library-derived): "Spec pass/fail" needs limits,
+ * "Test pass/fail" needs at least one recorded verdict. A functional active
+ * test returns no entries at all — its value mode IS test pass/fail, there is
+ * no alternative display to choose.
+ */
+export declare function passFailMenuRows(state: {
+    functionalActive: boolean;
+    hasLimits: boolean;
+    hasRecorded: boolean;
+    display: 'off' | 'spec' | 'test';
+}, setDisplay: (d: 'off' | 'spec' | 'test') => void): CheckMenuRow[];
+export declare function makeLogScaleBtn(helpers: ToolbarHelpers, getOpts: () => {
+    plotMode?: PlotMode;
+    logScale?: boolean;
+    passFailDisplay?: 'off' | 'spec' | 'test';
+    functionalActive?: boolean;
+}, setOpts: (patch: {
+    logScale: boolean;
+}) => void): {
+    btn: HTMLButtonElement;
+    sync: () => void;
+};
+export type LegendPosition = 'default' | 'compact' | 'left' | 'top' | 'bottom' | 'floating';
+export declare function makeLegendStyleBtn(helpers: ToolbarHelpers, getOpts: () => {
+    plotMode?: PlotMode;
+    legendPosition?: LegendPosition;
+}, setLegendPosition: (v: LegendPosition) => void): {
+    btn: HTMLButtonElement;
+    sync: () => void;
+};
+export declare function makeOverlaysBtn(helpers: ToolbarHelpers, getRows: () => CheckMenuRow[], isAnyOn: () => boolean): HTMLButtonElement;
+export declare function makeOrientationBtn(helpers: ToolbarHelpers, getOpts: () => {
+    rotation?: number;
+    flipX?: boolean;
+    flipY?: boolean;
+}, setOpts: (patch: {
+    rotation?: 0 | 90 | 180 | 270;
+    flipX?: boolean;
+    flipY?: boolean;
+}) => void): HTMLButtonElement;
+type GuideApi = {
+    buildWaferMap: unknown;
+    renderWaferMap: unknown;
+    renderWaferGallery: unknown;
+    analyzeWaferMap: unknown;
+};
+/**
+ * Host-supplied content inserted into wmap's own embedded user-guide window,
+ * so a host app's own documentation and wmap's reference live behind one
+ * help button instead of two separate ones.
+ */
+export interface UserGuideExtension {
+    /**
+     * Host-provided HTML, inserted before wmap's own guide content. Static
+     * content only — must not contain `<script>` tags. wmap re-executes
+     * exactly one inline script (its own live-demo bootstrap, always the
+     * last element in `html`) by finding the content div's first
+     * `<script>` in document order; a `<script>` in this HTML would be
+     * found instead, silently breaking wmap's own live demos.
+     */
+    html: string;
+    /**
+     * Overrides the window's title text (default `'Wafer Map — User Guide'`).
+     * Use this when the host's own content should frame the whole document —
+     * wmap's own `<h1>` stays as-is further down the page, so the result
+     * reads as one combined guide with the host's section first, not a title
+     * rewrite.
+     */
+    title?: string;
+}
+/**
+ * Open the embedded user-guide window and populate its live demos. Closes any
+ * previously open guide window first (at most one may be open at a time).
+ * `api` must contain the four library functions the guide demos call at runtime.
+ * `html` is USER_GUIDE_HTML — passed in so toolbar.ts has no dependency on userGuideHtml.ts.
+ * `extension`, when provided, prepends host content and/or overrides the window title — see `UserGuideExtension`.
+ *
+ * Opens a real, separate window when available (draggable outside the host
+ * window's own bounds), falling back to the in-page floating window when
+ * `window.open` is blocked/unavailable — silently returns `null` in some
+ * embedded WebViews (Tauri, Electron, WebView2), same gap `openDetachWindow`
+ * exists for. Unlike gallery card detach, this doesn't go through
+ * `setDetachWindowOpener` — that opener's contract is scoped to per-wafer
+ * detach windows a host may have built specifically for that shape of
+ * content, and reusing it silently for the guide would broaden it without
+ * documentation.
+ */
+export declare function openUserGuideWindow(api: GuideApi, html: string, extension?: UserGuideExtension, anchor?: Element): void;
+export {};
+//# sourceMappingURL=toolbar.d.ts.map

package/dist/packages/canvas-adapter/toolbar.js

@@ -0,0 +1,9 @@
+import{getUniqueTestNumbers as ue}from"../renderer/buildView.js";import{dieHasTestData as pe}from"../renderer/buildWaferMap.js";import{prettyKey as me}from"../core/utils.js";import{listColorSchemes as oe}from"../renderer/colorSchemes.js";import{ICONS as _}from"./icons.js";import{WMAP_VERSION as fe,WMAP_BUILD_TIME as be}from"./version.js";let ie=!1;export function logWmapVersionOnce(){ie||(ie=!0,console.log(`[wmap] v${fe} (built ${be})`))}export const WMAP_TOKEN_NAMES=["z","icon","icon-hover","icon-active","bg-hover","bg-active","separator","surface","border","menu-hover","menu-active","panel-bg","text-muted","text","text-strong","warn-bg","warn-border","warn-text","info-bg","info-text","selected","finding-indicator","canvas-bg"];const y=(e,t)=>`var(--wmap-${e}, ${t})`;export const CLR={icon:y("icon","#506784"),iconHover:y("icon-hover","#2a3f5f"),iconActive:y("icon-active","#1a65ca"),bgHover:y("bg-hover","#edf0f8"),bgActive:y("bg-active","#dce8f8"),separator:y("separator","rgba(0,0,0,0.12)"),menuBg:y("surface","#fff"),menuBorder:y("border","rgba(0,0,0,0.12)"),menuHover:y("menu-hover","#f0f4fc"),menuActive:y("menu-active","#dce8f8"),panelBg:y("panel-bg","#fafbfc"),label:y("text-muted","#647687"),value:y("text-strong","#1f2f43"),text:y("text","#333"),warnBg:y("warn-bg","#fffbe6"),warnBorder:y("warn-border","#f0c040"),warnText:y("warn-text","#7a5800"),infoBg:y("info-bg","#dce8f8"),infoText:y("info-text","#334155"),findingHighlight:y("selected","#e07a20"),findingIndicator:y("finding-indicator","#b7551a")};export function sevColor(e){return e==="unusual"?"#a84112":e==="notable"?"#8a6500":CLR.icon}export const ROTATIONS=[0,90,180,270],INLINE_TEST_LIMIT=6,MENU_SEARCH_THRESHOLD=8,DEFAULT_OVERLAY_Z=6e3,Z_BASE=`var(--wmap-z, ${DEFAULT_OVERLAY_Z})`,Z_ABOVE=`calc(var(--wmap-z, ${DEFAULT_OVERLAY_Z}) + 1)`,Z_ABOVE2=`calc(var(--wmap-z, ${DEFAULT_OVERLAY_Z}) + 2)`;export function applyOverlayZ(e){if(e==null)return()=>{};const t=document.documentElement,n=t.style.getPropertyValue("--wmap-z");return t.style.setProperty("--wmap-z",String(e)),()=>{n?t.style.setProperty("--wmap-z",n):t.style.removeProperty("--wmap-z")}}export function copyWmapThemeTokens(e,t){const n=getComputedStyle(e);for(const a of WMAP_TOKEN_NAMES){const i=n.getPropertyValue(`--wmap-${a}`).trim();i&&t.style.setProperty(`--wmap-${a}`,i)}}export function syncWmapPopupTheme(e,t,n){const a=()=>{copyWmapThemeTokens(e,t),n?.()},i=new window.MutationObserver(a);i.observe(e,{attributes:!0,attributeFilter:["style","class"]}),i.observe(document.documentElement,{attributes:!0,attributeFilter:["style","class"]});const s=window.matchMedia("(prefers-color-scheme: dark)");return s.addEventListener("change",a),()=>{i.disconnect(),s.removeEventListener("change",a)}}let ee=null;export function setDetachWindowOpener(e){ee=e}export function openDetachWindow(e){return ee?ee(e):window.open("","_blank","width=560,height=600")}export const MODE_LABELS={value:"Test Value",hardBin:"Hard Bin",softBin:"Soft Bin",stackedValues:"Stacked Test Values",stackedBins:"Stacked Hard Bins",stackedSoftBins:"Stacked Soft Bins",metadata:"Metadata"},BIN_LEGEND_MODES=new Set(["hardBin","softBin","metadata"]),STACKED_MODES=new Set(["stackedValues","stackedBins","stackedSoftBins"]);export function saveImageBlob(e,t,n){const a=`${t}.png`;if(n){n(e,a);return}const i=URL.createObjectURL(e),s=document.createElement("a");s.href=i,s.download=a,s.click(),URL.revokeObjectURL(i)}export function saveTextFile(e,t,n,a){if(a){a(e,t,n);return}const i=new Blob([e],{type:n}),s=URL.createObjectURL(i),l=document.createElement("a");l.href=s,l.download=t,l.click(),URL.revokeObjectURL(s)}const he='[role="menuitem"],[role="menuitemradio"],[role="menuitemcheckbox"]';export function nextFrame(e,t=window){const n=t.requestAnimationFrame;typeof n=="function"?n.call(t,e):setTimeout(e,0)}function Oe(e,t,n){e.setAttribute("role","menu"),e.setAttribute("aria-label",t);for(const a of Array.from(e.children)){const i=n(a);i&&(a.setAttribute("role",i),a.tabIndex=-1)}}function G(e,t,n){const a=()=>Array.from(e.querySelectorAll(he));e.addEventListener("keydown",s=>{const l=a();if(l.length===0)return;const o=document.activeElement,d=o?l.indexOf(o):-1;switch(s.key){case"ArrowDown":s.preventDefault(),l[d<0||d===l.length-1?0:d+1].focus();break;case"ArrowUp":s.preventDefault(),l[d<=0?l.length-1:d-1].focus();break;case"Home":s.preventDefault(),l[0].focus();break;case"End":s.preventDefault(),l[l.length-1].focus();break;case"Enter":case" ":d>=0&&(s.preventDefault(),l[d].click());break;case"Escape":case"Tab":s.preventDefault(),n(),t?.focus();break}});const i=a()[0];i&&nextFrame(()=>i.focus())}export function overlayRootFor(e){let t=e;for(;t;){if(t.classList.contains("wmap-overlay-box")||t.tagName==="DIALOG"&&t.matches(":modal"))return t;t=t.parentElement}return e.ownerDocument.body}const te=new WeakMap;export function getTooltip(e=document){const t=te.get(e);if(t&&t.isConnected)return t;const n=t??e.createElement("div");return t||(Object.assign(n.style,{position:"fixed",pointerEvents:"none",background:"rgba(30, 32, 40, 0.93)",color:"#f0f0f2",border:"1px solid rgba(255,255,255,0.10)",padding:"7px 11px",borderRadius:"5px",fontSize:"13px",lineHeight:"1.55",maxWidth:"280px",maxHeight:"min(60vh, 480px)",overflow:"hidden",whiteSpace:"pre-wrap",zIndex:Z_ABOVE,display:"none",fontFamily:"system-ui, sans-serif",boxShadow:"0 3px 10px rgba(0,0,0,0.45)"}),te.set(e,n)),e.body.appendChild(n),n}export function hideTooltip(e=document){const t=te.get(e);t&&(t.style.display="none")}export function reparentTooltip(e){const t=e?.ownerDocument??document,n=getTooltip(t);(e??t.body).appendChild(n)}export function positionTooltip(e,t,n,a){const i=overlayRootFor(t);e.parentElement!==i&&i.appendChild(e);const s=e.ownerDocument.defaultView??window;e.style.left="0",e.style.top="0";const l=e.offsetWidth,o=e.offsetHeight,d=8;let h=n+14,c=a-8;h+l+d>s.innerWidth&&(h=n-l-6),c+o+d>s.innerHeight&&(c=s.innerHeight-o-d),c<d&&(c=d),e.style.left=`${h}px`,e.style.top=`${c}px`}export function buildDataModeEntries(e,t,n){const a=e.some(pe),i=e.some(c=>c.testValues!==void 0&&Object.keys(c.testValues).length>0),s=e.some(c=>c.hbin!=null),l=e.some(c=>c.sbin!=null),o=a?t?.length?t.map(c=>({plotMode:"value",activeTest:c.testNumber,label:c.unit?`${c.name} (${c.unit})`:c.name,logScale:c.logScale})):ue(e).map(c=>({plotMode:"value",activeTest:c,label:`Test ${c}`})):[],d=[...s?[{plotMode:"hardBin",label:MODE_LABELS.hardBin}]:[],...l?[{plotMode:"softBin",label:MODE_LABELS.softBin}]:[]],h=n.includeStacked?[...i?[{plotMode:"stackedValues",label:MODE_LABELS.stackedValues}]:[],...s?[{plotMode:"stackedBins",label:MODE_LABELS.stackedBins}]:[],...l?[{plotMode:"stackedSoftBins",label:MODE_LABELS.stackedSoftBins}]:[]]:[];return{testEntries:o,binEntries:d,stackedEntries:h}}export function metadataKeyHasData(e,t){return e.some(n=>n.metadata?.[t]!==void 0&&n.metadata?.[t]!==null)}export function metadataModeEntry(e){return{plotMode:"metadata",activeMetadataKey:e.key,label:e.label??me(e.key)}}export function makeMenuSearchBox(e,t="Filter\u2026"){const n=document.createElement("input");return n.type="text",n.placeholder=t,n.setAttribute("aria-label",t),Object.assign(n.style,{display:"block",width:"calc(100% - 20px)",margin:"2px 10px 6px",padding:"4px 8px",fontSize:"12px",boxSizing:"border-box",background:CLR.menuBg,color:CLR.text,border:`1px solid ${CLR.menuBorder}`,borderRadius:"4px",outline:"none"}),n.addEventListener("click",a=>a.stopPropagation()),n.addEventListener("mousedown",a=>a.stopPropagation()),n.addEventListener("keydown",a=>a.stopPropagation()),n.addEventListener("input",()=>e(n.value.trim().toLowerCase())),n.addEventListener("focus",()=>{n.style.borderColor=CLR.iconActive}),n.addEventListener("blur",()=>{n.style.borderColor=CLR.menuBorder}),queueMicrotask(()=>n.focus()),n}export function buildModeMenuEl(e,t,n,a,i,s,l,o,d=window,h=[]){const{makeMenuRow:c,makeMenuSection:p}=l,r=document.createElement("div"),v=180,x=e.left+v<=(d.innerWidth??1/0)?e.left:Math.max(4,e.right-v);if(Object.assign(r.style,{position:"fixed",top:`${e.bottom+4}px`,left:`${x}px`,background:CLR.menuBg,border:`1px solid ${CLR.menuBorder}`,borderRadius:"4px",boxShadow:"0 4px 12px rgba(0,0,0,0.15)",zIndex:Z_BASE,minWidth:`${v}px`,padding:"4px 0",pointerEvents:"auto"}),t.length)if(r.appendChild(p("Test Value")),t.length<=INLINE_TEST_LIMIT)for(const g of t)r.appendChild(c(g.label,i(g),!0,f=>{f.stopPropagation(),s(g,r)}));else{const g=o==="value",f=c(MODE_LABELS.value+" \u25B6",g,!1,()=>{});f.style.display="flex",f.style.justifyContent="space-between",f.style.alignItems="center";let b=null,M=null;const A=()=>{M!==null&&(clearTimeout(M),M=null)},E=()=>{A(),b?.remove(),b=null},U=()=>{A(),M=setTimeout(E,300)},F=()=>{if(b)return;const L=f.getBoundingClientRect(),w=160,C=320,I=L.right+2+w<=(d.innerWidth??1/0)?L.right+2:Math.max(4,L.left-2-w),T=Math.min(L.top-4,Math.max(4,(d.innerHeight??1/0)-C-4));if(b=document.createElement("div"),Object.assign(b.style,{position:"fixed",top:`${T}px`,left:`${I}px`,background:CLR.menuBg,border:`1px solid ${CLR.menuBorder}`,borderRadius:"4px",boxShadow:"0 4px 12px rgba(0,0,0,0.15)",zIndex:Z_ABOVE,minWidth:`${w}px`,maxHeight:`${C}px`,overflowY:"auto",padding:"4px 0",pointerEvents:"auto"}),t.length>MENU_SEARCH_THRESHOLD){const S=makeMenuSearchBox(j=>{for(const O of k)O.row.style.display=O.label.includes(j)?"":"none"},"Filter tests\u2026");Object.assign(S.style,{position:"sticky",top:"0",zIndex:"1",background:CLR.menuBg}),b.appendChild(S)}const k=[];for(const S of t){const j=c(S.label,i(S),!1,O=>{O.stopPropagation(),E(),s(S,r)});k.push({row:j,label:S.label.toLowerCase()}),b.appendChild(j)}b.addEventListener("mouseenter",A),b.addEventListener("mouseleave",U),(r.parentElement??d.document.body).appendChild(b),d.document.addEventListener("click",E,{once:!0})};f.addEventListener("mouseenter",()=>{A(),F()}),f.addEventListener("mouseleave",U),r.appendChild(f)}if(n.length){r.appendChild(p("Bins"));for(const g of n)r.appendChild(c(g.label,i(g),!1,f=>{f.stopPropagation(),s(g,r)}))}if(h.length){r.appendChild(p("Metadata"));for(const g of h)r.appendChild(c(g.label,i(g),!1,f=>{f.stopPropagation(),s(g,r)}))}if(a.length){r.appendChild(p("Lot Aggregation"));for(const g of a)r.appendChild(c(g.label,i(g),!1,f=>{f.stopPropagation(),s(g,r)}))}return r.setAttribute("role","menu"),r.setAttribute("aria-label","Plot mode"),r}export function markMenuTrigger(e,t){e.setAttribute("aria-haspopup","menu"),e.setAttribute("aria-expanded",t?"true":"false")}export function wireMenuA11y(e,t,n){G(e,t,n)}export function wireExpandToggle(e,t){const n=e.ownerDocument;let a=!1;function i(h){a!==h&&(a=h,t(a))}function s(){i(!1)}function l(){i(!a),a&&n.addEventListener("click",s,{once:!0})}const o=h=>{h.stopPropagation(),l()},d=h=>{h.key==="Enter"||h.key===" "?(h.preventDefault(),l()):h.key==="Escape"&&s()};return e.setAttribute("role","button"),e.tabIndex<0&&(e.tabIndex=0),e.addEventListener("click",o),e.addEventListener("keydown",d),{isOpen:()=>a,close:s,destroy(){e.removeEventListener("click",o),e.removeEventListener("keydown",d),n.removeEventListener("click",s)}}}export function buildCheckMenuEl(e,t,n,a=window){const{makeMenuRow:i,makeMenuSection:s}=n,l=document.createElement("div"),o=168,h=e.left+o<=(a.innerWidth??1/0)?e.left:Math.max(4,e.right-o);Object.assign(l.style,{position:"fixed",top:`${e.bottom+4}px`,left:`${h}px`,background:CLR.menuBg,border:`1px solid ${CLR.menuBorder}`,borderRadius:"4px",boxShadow:"0 4px 12px rgba(0,0,0,0.15)",zIndex:Z_BASE,minWidth:`${o}px`,padding:"4px 0",pointerEvents:"auto"});for(const c of t)if("section"in c)l.appendChild(s(c.section));else{if(!(c.enabled!==!1))continue;const r=document.createElement("div");r.setAttribute("role","menuitemcheckbox"),r.setAttribute("aria-checked",c.active?"true":"false"),r.tabIndex=-1,Object.assign(r.style,{display:"flex",alignItems:"center",gap:"6px",padding:"6px 14px",fontSize:"12px",cursor:"pointer",color:c.active?CLR.iconActive:CLR.text,fontWeight:c.active?"700":"400",background:c.active?CLR.menuActive:"transparent",whiteSpace:"nowrap",outline:"none"});const v=document.createElement("span");Object.assign(v.style,{width:"12px",flexShrink:"0",color:CLR.iconActive,visibility:c.active?"visible":"hidden"}),v.textContent="\u2713",v.setAttribute("aria-hidden","true");const m=document.createElement("span");m.textContent=c.label,r.appendChild(v),r.appendChild(m),r.addEventListener("mouseenter",()=>{c.active||(r.style.background=CLR.menuHover)}),r.addEventListener("mouseleave",()=>{r.style.background=c.active?CLR.menuActive:"transparent"}),r.addEventListener("focus",()=>{c.active||(r.style.background=CLR.menuHover)}),r.addEventListener("blur",()=>{r.style.background=c.active?CLR.menuActive:"transparent"}),r.addEventListener("click",x=>{x.stopPropagation(),c.onClick(x)}),l.appendChild(r)}return l}export function createToolbarHelpers(e){let t=null;const n=p=>overlayRootFor(p);function a(p,r,v){const m=document.createElement("button");return m.innerHTML=_[p],m.type="button",m.ariaLabel=r,Object.assign(m.style,{display:"flex",alignItems:"center",justifyContent:"center",width:"28px",height:"28px",padding:"0",border:"none",borderRadius:"3px",background:"transparent",color:CLR.icon,cursor:"pointer",pointerEvents:"auto",transition:"background 0.12s, color 0.12s",flexShrink:"0"}),m.addEventListener("mouseenter",x=>{m.dataset.active||(m.style.background=CLR.bgHover,m.style.color=CLR.iconHover),e.innerHTML=m.ariaLabel??r,e.style.display="block",positionTooltip(e,m,x.clientX,x.clientY)}),m.addEventListener("mousemove",x=>{e.style.display==="block"&&positionTooltip(e,m,x.clientX,x.clientY)}),m.addEventListener("mouseleave",()=>{m.dataset.active||(m.style.background="transparent",m.style.color=CLR.icon),e.style.display="none"}),m.addEventListener("click",()=>{e.style.display="none",v()}),m}function i(p,r){r?(p.dataset.active="1",p.style.background=CLR.bgActive,p.style.color=CLR.iconActive):(delete p.dataset.active,p.style.background="transparent",p.style.color=CLR.icon)}function s(){const p=document.createElement("div");return Object.assign(p.style,{width:"1px",height:"18px",background:CLR.separator,margin:"0 2px",flexShrink:"0"}),p}function l(p,r,v,m){const x=document.createElement("div");return x.textContent=p,x.setAttribute("role","menuitemradio"),x.setAttribute("aria-checked",r?"true":"false"),x.tabIndex=-1,Object.assign(x.style,{padding:`6px 14px 6px ${v?"26px":"14px"}`,fontSize:"12px",cursor:"pointer",color:r?CLR.iconActive:CLR.text,fontWeight:r?"700":"400",background:r?CLR.menuActive:"transparent",whiteSpace:"nowrap",outline:"none"}),x.addEventListener("mouseenter",()=>{r||(x.style.background=CLR.menuHover)}),x.addEventListener("mouseleave",()=>{x.style.background=r?CLR.menuActive:"transparent"}),x.addEventListener("focus",()=>{r||(x.style.background=CLR.menuHover)}),x.addEventListener("blur",()=>{x.style.background=r?CLR.menuActive:"transparent"}),x.addEventListener("click",m),x}function o(p){const r=document.createElement("div");return r.textContent=p,r.setAttribute("role","presentation"),Object.assign(r.style,{padding:"5px 14px 2px",fontSize:"10px",fontWeight:"600",letterSpacing:"0.05em",color:CLR.label,textTransform:"uppercase",pointerEvents:"none",userSelect:"none"}),r}function d(p,r,v,m,x){const g=()=>{t&&(t.remove(),t=null),f.setAttribute("aria-expanded","false")},f=a(p,r,()=>{if(t){g();return}const b=document.createElement("div"),M=f.getBoundingClientRect(),A=f.ownerDocument.defaultView??window,E=148,F=M.left+E<=(A.innerWidth??1/0)?M.left:Math.max(4,M.right-E);Object.assign(b.style,{position:"fixed",top:`${M.bottom+4}px`,left:`${F}px`,background:CLR.menuBg,border:`1px solid ${CLR.menuBorder}`,borderRadius:"4px",boxShadow:"0 4px 12px rgba(0,0,0,0.15)",zIndex:Z_BASE,minWidth:`${E}px`,padding:"4px 0",pointerEvents:"auto"});for(const L of v()){const w=document.createElement("div");w.textContent=L.label,w.dataset.wmapDropdownValue=L.value;const C=L.value===m();w.setAttribute("role","menuitemradio"),w.setAttribute("aria-checked",C?"true":"false"),w.tabIndex=-1,Object.assign(w.style,{padding:"6px 14px",fontSize:"12px",cursor:"pointer",color:C?CLR.iconActive:CLR.text,fontWeight:C?"700":"400",background:C?CLR.menuActive:"transparent",whiteSpace:"nowrap",outline:"none"});const D=()=>{L.value!==m()&&(w.style.background=CLR.menuHover)},I=()=>{w.style.background=L.value===m()?CLR.menuActive:"transparent"};w.addEventListener("mouseenter",D),w.addEventListener("mouseleave",I),w.addEventListener("focus",D),w.addEventListener("blur",I),w.addEventListener("click",T=>{T.stopPropagation(),x(L.value),g()}),b.appendChild(w)}b.setAttribute("role","menu"),b.setAttribute("aria-label",r),n(f).appendChild(b),t=b,f.setAttribute("aria-expanded","true"),G(b,f,g)});return f.setAttribute("aria-haspopup","menu"),f.setAttribute("aria-expanded","false"),f}function h(p,r,v,m){function x(){return buildCheckMenuEl(f.getBoundingClientRect(),v().map(b=>"section"in b?b:{...b,onClick:M=>{b.onClick(M),m(f);const A=t;if(!A)return;const E=x();E.setAttribute("role","menu"),E.setAttribute("aria-label",r),A.replaceWith(E),t=E,G(E,f,g)}}),{makeMenuRow:l,makeMenuSection:o},f.ownerDocument.defaultView??window)}const g=()=>{t&&(t.remove(),t=null),f.setAttribute("aria-expanded","false")},f=a(p,r,()=>{if(t){g();return}const b=x();b.setAttribute("role","menu"),b.setAttribute("aria-label",r),n(f).appendChild(b),t=b,f.setAttribute("aria-expanded","true"),G(b,f,g)});return f.setAttribute("aria-haspopup","menu"),f.setAttribute("aria-expanded","false"),m(f),f}function c(p){if(t&&!t.contains(p.target)&&(t.remove(),t=null,p.target?.getAttribute?.("aria-haspopup")!=="menu"))for(const v of document.querySelectorAll('[aria-haspopup="menu"][aria-expanded="true"]'))v.setAttribute("aria-expanded","false")}return{makeBtn:a,setActive:i,makeSep:s,makeMenuRow:l,makeMenuSection:o,makeDropdown:d,makeCheckMenuBtn:h,closeOpenMenu:c,getOpenMenu:()=>t,setOpenMenu:p=>{t=p}}}const xe=7e3;let ve=0;function ae(){return xe+ ++ve}const ge=32,ye=6;let we=0;function ke(){return we++%ye*ge}function Ee(e,t){if(t===e.body)return()=>{};let n=t;for(;n.parentElement&&n.parentElement!==e.body;)n=n.parentElement;return n===e.body?()=>{}:(n.classList.add("wmap-overlay-ancestor"),()=>n.classList.remove("wmap-overlay-ancestor"))}function re(e){const t=e.mode==="modal",n=e.ownerDocument??document,a=n.defaultView??window,i=n.body.style.overflow;t&&(n.body.style.overflow="hidden");let s=null;t&&(s=n.createElement("div"),s.id="wmap-modal-backdrop",Object.assign(s.style,{position:"fixed",inset:"0",background:"rgba(0,0,0,0.6)",display:"flex",alignItems:"center",justifyContent:"center",zIndex:Z_ABOVE,backdropFilter:"blur(3px)"}));const l=n.activeElement,o=n.createElement("div");if(o.className=t?"wmap-modal-box wmap-overlay-box":"wmap-window-box wmap-overlay-box",o.setAttribute("role","dialog"),t&&o.setAttribute("aria-modal","true"),o.setAttribute("aria-label",e.title??"Expanded wafer map"),o.tabIndex=-1,Object.assign(o.style,{position:"relative",background:CLR.menuBg,borderRadius:"12px",overflow:"hidden",display:"flex",flexDirection:"column",width:"min(90vw, 700px)",height:"min(90vh, 700px)",boxShadow:"0 20px 60px rgba(0,0,0,0.4)",minWidth:"320px",minHeight:"240px",maxWidth:"100vw",maxHeight:"100vh",zIndex:t?Z_ABOVE2:String(ae())}),!t){const u=ke();Object.assign(o.style,{position:"fixed",top:`${Math.round(a.innerHeight*.08)+u}px`,left:`${Math.round(a.innerWidth*.08)+u}px`})}const d=n.createElement("div");Object.assign(d.style,{display:"flex",alignItems:"center",gap:"6px",padding:"10px 14px",borderBottom:`1px solid ${CLR.menuBorder}`,flexShrink:"0"});const h={border:`1px solid ${CLR.menuBorder}`,borderRadius:"4px",background:CLR.panelBg,cursor:"pointer",color:CLR.label,lineHeight:"1",padding:"0",display:"flex",alignItems:"center",justifyContent:"center",width:"28px",height:"28px"};if(e.title){const u=n.createElement("span");u.textContent=e.title,u.title=e.title,u.dataset.wmapWindowTitle="1",Object.assign(u.style,{fontWeight:"700",fontSize:"14px",overflow:"hidden",textOverflow:"ellipsis",whiteSpace:"nowrap",minWidth:"0"}),d.appendChild(u)}const c=n.createElement("div");c.style.flex="1",d.appendChild(c);let p=null;t||(p=n.createElement("button"),p.type="button",p.innerHTML=_.windowMinimize,p.title="Minimize",p.setAttribute("aria-label","Minimize"),Object.assign(p.style,h),p.addEventListener("click",()=>U(!b)),d.appendChild(p));const r=n.createElement("button");r.type="button",r.innerHTML=_.maximize,r.title="Maximize (F)",r.setAttribute("aria-label","Maximize"),Object.assign(r.style,h),r.addEventListener("click",()=>f(!m));const v=n.createElement("button");v.type="button",v.innerHTML=_.close,v.title="Close (Esc)",v.setAttribute("aria-label","Close"),Object.assign(v.style,h),v.addEventListener("click",D),d.appendChild(r),d.appendChild(v);let m=!1,x="",g="";function f(u){m=u,r.innerHTML=m?_.minimize:_.maximize,r.title=m?"Restore (F)":"Maximize (F)",r.setAttribute("aria-label",m?"Restore":"Maximize"),k.style.display=m?"none":"block",m?(o.style.borderRadius="0",o.style.width="100vw",o.style.height="100vh",t||(x=o.style.top,g=o.style.left,o.style.top="0",o.style.left="0")):(o.style.borderRadius="12px",o.style.width="min(90vw, 700px)",o.style.height="min(90vh, 700px)",t||(o.style.top=x,o.style.left=g)),e.onMaximizeChange?.(m,o)}let b=!1,M="",A="";const E=220;function U(u){b=u,p.innerHTML=b?_.windowRestore:_.windowMinimize,p.title=b?"Restore":"Minimize",p.setAttribute("aria-label",b?"Restore":"Minimize"),k.style.display=b?"none":"block",b?(M=o.style.height,A=o.style.width,o.style.minHeight="0",o.style.height="auto",o.style.minWidth="0",o.style.width=`${E}px`,r.disabled=!0,r.style.opacity="0.4",r.style.cursor="default",T.style.display="none"):(o.style.minHeight="240px",o.style.height=M||"min(90vh, 700px)",o.style.minWidth="320px",o.style.width=A||"min(90vw, 700px)",r.disabled=!1,r.style.opacity="1",r.style.cursor="pointer",T.style.display="flex")}function F(){const u=n.body.style.userSelect;return n.body.style.userSelect="none",()=>{n.body.style.userSelect=u}}t||(d.style.cursor="move",d.addEventListener("pointerdown",u=>{if(m||u.target.closest('button, [role="button"]'))return;u.preventDefault();const B=F(),W=u.clientX,z=u.clientY,H=o.offsetTop,R=o.offsetLeft,Z=a.innerHeight-d.offsetHeight,Q=a.innerWidth-40,X=40-o.offsetWidth;d.setPointerCapture(u.pointerId);const N=V=>{const J=Math.min(Math.max(H+(V.clientY-z),0),Z),de=Math.min(Math.max(R+(V.clientX-W),X),Q);o.style.top=`${J}px`,o.style.left=`${de}px`},P=V=>{B(),d.releasePointerCapture(V.pointerId),d.removeEventListener("pointermove",N),d.removeEventListener("pointerup",P)};d.addEventListener("pointermove",N),d.addEventListener("pointerup",P)}));const L='button,[href],input,select,textarea,[tabindex]:not([tabindex="-1"]),[role="menuitem"],[role="menuitemradio"],[role="menuitemcheckbox"]';function w(u){const B=Array.from(o.querySelectorAll(L)).filter(R=>R.offsetParent!==null||R===n.activeElement);if(B.length===0){u.preventDefault(),o.focus();return}const W=B[0],z=B[B.length-1],H=n.activeElement;u.shiftKey&&(H===W||!o.contains(H))?(u.preventDefault(),z.focus()):!u.shiftKey&&H===z&&(u.preventDefault(),W.focus())}const C=u=>{if(u.key==="Escape"){D();return}if(t&&(u.key==="e"||u.key==="E")){D();return}if(t&&u.key==="Tab"){w(u);return}(u.key==="f"||u.key==="F")&&!b&&f(!m)};function D(){t?n.removeEventListener("keydown",C):o.removeEventListener("keydown",C),q.remove(),ce(),hideTooltip(n),reparentTooltip(n.body),s?s.remove():o.remove(),t&&(n.body.style.overflow=i),l?.focus?.(),e.onClose()}function I(){t||(o.style.zIndex=String(ae()))}const T=n.createElement("div");Object.assign(T.style,{flex:"1",minHeight:"0",minWidth:"0",display:"flex",overflow:"hidden"});const k=n.createElement("div");k.tabIndex=0,k.setAttribute("role","separator"),k.setAttribute("aria-label","Resize window (arrow keys, or drag)"),Object.assign(k.style,{position:"absolute",right:"0",bottom:"0",width:"16px",height:"16px",cursor:"nwse-resize",touchAction:"none"}),k.innerHTML='<svg viewBox="0 0 16 16" width="16" height="16" style="display:block"><path d="M15 15 L15 9 M15 15 L9 15 M15 15 L15 3 M15 15 L3 15" stroke="currentColor" stroke-width="1" opacity="0.35" fill="none"/></svg>',k.style.color=CLR.label;const S=320,j=240,O=20;function Y(u,B){const W=a.innerWidth-o.offsetLeft,z=a.innerHeight-o.offsetTop,H=Math.min(Math.max(o.offsetWidth+u,S),W),R=Math.min(Math.max(o.offsetHeight+B,j),z);o.style.width=`${H}px`,o.style.height=`${R}px`}k.addEventListener("keydown",u=>{if(!(m||b))switch(u.key){case"ArrowRight":u.preventDefault(),Y(O,0);break;case"ArrowLeft":u.preventDefault(),Y(-O,0);break;case"ArrowDown":u.preventDefault(),Y(0,O);break;case"ArrowUp":u.preventDefault(),Y(0,-O);break}}),k.addEventListener("pointerdown",u=>{if(m||b)return;u.preventDefault();const B=F(),W=u.clientX,z=u.clientY,H=o.offsetWidth,R=o.offsetHeight,Z=a.innerWidth-o.offsetLeft,Q=a.innerHeight-o.offsetTop;k.setPointerCapture(u.pointerId);const X=P=>{const V=Math.min(Math.max(H+(P.clientX-W),S),Z),J=Math.min(Math.max(R+(P.clientY-z),j),Q);o.style.width=`${V}px`,o.style.height=`${J}px`},N=P=>{B(),k.releasePointerCapture(P.pointerId),k.removeEventListener("pointermove",X),k.removeEventListener("pointerup",N)};k.addEventListener("pointermove",X),k.addEventListener("pointerup",N)}),o.appendChild(d),o.appendChild(T),o.appendChild(k);const K=e.anchor?overlayRootFor(e.anchor):n.body;s?(s.appendChild(o),K.appendChild(s)):K.appendChild(o);const ce=Ee(n,K),q=n.createElement("style");return q.textContent=`@media print{
+body{overflow:visible!important;height:auto!important}
+body>*:not(.wmap-overlay-box):not(#wmap-modal-backdrop):not(.wmap-overlay-ancestor){display:none!important}
+#wmap-modal-backdrop{position:static!important;background:none!important;backdrop-filter:none!important;display:block!important}
+.wmap-overlay-box{position:static!important;width:auto!important;height:auto!important;max-width:none!important;max-height:none!important;min-width:0!important;min-height:0!important;box-shadow:none!important;border-radius:0!important;overflow:visible!important;display:block!important}
+.wmap-overlay-box>div:first-child{display:none!important}
+.wmap-overlay-box>div:nth-child(2){display:block!important;overflow:visible!important;height:auto!important;flex:none!important;min-height:0!important;min-width:0!important}
+.wmap-overlay-box>div:nth-child(3){display:none!important}
+}`,n.head.appendChild(q),reparentTooltip(o),t?(s.addEventListener("click",u=>{u.target===s&&D()}),n.addEventListener("keydown",C)):(o.addEventListener("keydown",C),o.addEventListener("mousedown",I),I()),nextFrame(()=>(v.isConnected?v:o).focus(),a),{backdrop:s,box:o,contentWrap:T,close:D,bringToFront:I}}export function openModal(e){return re({...e,mode:"modal"})}export function openFloatingWindow(e){return re({...e,mode:"window"})}const ne=new WeakSet;export function openReparentedModal(e,t={}){if(e.length===0||e.some(i=>ne.has(i)))return null;const n=e.map(i=>({el:i,parent:i.parentElement,next:i.nextSibling})),a=openModal({ownerDocument:t.ownerDocument,title:t.title,anchor:e[0],onClose:()=>{for(const i of n){if(ne.delete(i.el),!i.parent)continue;const s=i.next&&i.next.parentNode===i.parent?i.next:null;i.parent.insertBefore(i.el,s)}t.onClosed?.()}});for(const i of n)ne.add(i.el),a.contentWrap.appendChild(i.el);return a}export function makePaletteBtn(e,t,n,a,i){const s=e.makeDropdown("palette","Colour scheme",()=>{const d=t()==="hardBin"||t()==="softBin"?oe().filter(h=>h.name==="default"||h.name==="accessible"):oe();return[...a()?[{value:"custom",label:"Custom"}]:[],...d.map(h=>({value:h.name,label:h.label}))]},()=>n(),o=>i(o));function l(){s.style.display=t()==="metadata"?"none":""}return{btn:s,sync:l}}export function requestedPassFailDisplay(e){return e.passFailDisplay??"off"}export function passFailMenuRows(e,t){if(e.functionalActive)return[];const n=[];return e.hasLimits&&n.push({label:"Spec pass/fail",active:e.display==="spec",onClick:()=>t(e.display==="spec"?"off":"spec")}),e.hasRecorded&&n.push({label:"Test pass/fail",active:e.display==="test",onClick:()=>t(e.display==="test"?"off":"test")}),n}export function makeLogScaleBtn(e,t,n){const a=e.makeBtn("logScale","Toggle log scale",()=>{n({logScale:!t().logScale})});function i(){const s=t(),l=s.plotMode,o=l==="value"||l==="stackedValues";a.style.display=o&&requestedPassFailDisplay(s)==="off"&&!s.functionalActive?"":"none",e.setActive(a,!!s.logScale)}return{btn:a,sync:i}}export function makeLegendStyleBtn(e,t,n){const a=e.makeDropdown("legend","Legend style",()=>[{value:"default",label:"Default (right)"},{value:"compact",label:"Compact (right)"},{value:"left",label:"Left"},{value:"top",label:"Top"},{value:"bottom",label:"Bottom"},{value:"floating",label:"Floating"}],()=>t().legendPosition??"default",s=>n(s));function i(){const s=t().plotMode;a.style.display=s==="hardBin"||s==="softBin"||s==="metadata"?"":"none"}return{btn:a,sync:i}}export function makeOverlaysBtn(e,t,n){return e.makeCheckMenuBtn("overlays","Overlays",()=>t(),a=>e.setActive(a,n()))}export function makeOrientationBtn(e,t,n){return e.makeCheckMenuBtn("orient","Orientation",()=>[{section:"Rotate"},{label:"Rotate 90\xB0 clockwise",active:!1,onClick:()=>{const a=t().rotation??0;n({rotation:ROTATIONS[(ROTATIONS.indexOf(a)+1)%4]})}},{section:"Flip"},{label:"Flip horizontal",active:!!t().flipX,onClick:()=>n({flipX:!t().flipX})},{label:"Flip vertical",active:!!t().flipY,onClick:()=>n({flipY:!t().flipY})}],a=>{const{rotation:i,flipX:s,flipY:l}=t();e.setActive(a,!!(i||s||l))})}let $=null;function se(e,t,n,a){const i=t,s=i.__wmapDemoApi;i.__wmapDemoApi=a;const l=e.createElement("div");return l.classList.add("wmap-guide-content"),l.innerHTML=n,{content:l,restoreApi:()=>{i.__wmapDemoApi===a&&(i.__wmapDemoApi=s)}}}function le(e,t){const n=t,a=e.querySelector("script");if(a){const i=e.ownerDocument.createElement("script");i.textContent=a.textContent,e.appendChild(i);const s=e.querySelector(".wmap-guide");return s&&n.__wmapPopulateGuideDemos?.(s),n.__wmapDestroyGuideDemos}}function Me(e,t,n,a){const{content:i,restoreApi:s}=se(document,window,t,n);Object.assign(i.style,{flex:"1",overflow:"auto",minHeight:"0"});let l;const o=openFloatingWindow({title:e,anchor:a,onMaximizeChange:d=>{i.querySelector(".wmap-guide")?.classList.toggle("wmap-guide--max",d)},onClose:()=>{$===o&&($=null),l?.(),s()}});return o.contentWrap.appendChild(i),l=le(i,window),o}function Le(e,t,n,a){const i=e.document;i.title=t,Object.assign(i.documentElement.style,{height:"100%"}),Object.assign(i.body.style,{margin:"0",height:"100vh",overflow:"hidden",display:"flex",flexDirection:"column",fontFamily:'system-ui, -apple-system, "Segoe UI", sans-serif'}),copyWmapThemeTokens(document.documentElement,i.documentElement);const s=syncWmapPopupTheme(document.documentElement,i.documentElement),{content:l,restoreApi:o}=se(i,e,n,a);Object.assign(l.style,{flex:"1",overflow:"auto",minHeight:"0"}),i.body.appendChild(l);const d=le(l,e);let h=!1;const c=()=>{if(!h){h=!0,clearInterval(p),s();try{d?.()}catch{}o(),$===r&&($=null)}},p=setInterval(()=>{e.closed&&c()},400);e.addEventListener("pagehide",c);const r={close:()=>{e.closed||e.close(),c()}};return r}export function openUserGuideWindow(e,t,n,a){$&&($.close(),$=null);const i=n?.title??"Wafer Map \u2014 User Guide",s=(n?.html??"")+t,l=window.open("","_blank","width=800,height=820");$=l?Le(l,i,s,e):Me(i,s,e,a)}