@webority/ui-elements 0.149.0 → 0.150.0

package/types/dataTable.d.ts

@@ -0,0 +1,159 @@
+/** A resized column never narrows past this, so its label and handle stay usable. */
+export declare const COLUMN_MIN_WIDTH = 48;
+/** Nor widens past this: the handle's range, which a focusable separator has to state. */
+export declare const COLUMN_MAX_WIDTH = 1200;
+/** Arrow keys on a resize handle move the edge by this; with Shift, by RESIZE_STEP_LARGE. */
+export declare const RESIZE_STEP = 10;
+export declare const RESIZE_STEP_LARGE = 50;
+/** The pin sides a column takes (`pin` on a React column, `data-pin` on a Razor header cell). */
+export declare const PIN_SIDES: string[];
+/** Rows rendered beyond each edge of a virtual table's box, so a fast scroll never shows a gap. */
+export declare const VIRTUAL_OVERSCAN = 8;
+/** A row's height at each density, until a rendered row is measured. */
+export declare const ROW_HEIGHTS: {
+    comfortable: number;
+    cozy: number;
+    compact: number;
+};
+export declare const DATA_TABLE_TEXT: {
+    resize: (label: string) => string;
+    width: (px: number) => string;
+    rows: (n: number) => string;
+    saved: (label: string) => string;
+    savedMany: (n: number) => string;
+    notSaved: (label: string, reason?: string) => string;
+};
+/** Formats a group's row count the way the group header shows it (Indian digit grouping). */
+export declare const groupCount: (n: number) => string;
+/** Clamps a dragged or typed width to the minimum and rounds it to whole pixels. */
+export declare const clampColumnWidth: (px: unknown) => number;
+/**
+ * Buckets items by group in the order each group first appears, keeping the items' own order inside
+ * each group, so a sorted list stays sorted within its groups. `order` (keys from an earlier pass)
+ * keeps the groups where they were while rows move.
+ * @param items
+ * @param keyOf
+ * @param order
+ */
+export declare function groupItems<T>(items: readonly T[], keyOf: (item: T, index: number) => string, order?: readonly string[]): {
+    key: string;
+    items: T[];
+}[];
+/**
+ * The slice of a list of uniform rows to render in a scroll box: rows from `start` to `end`
+ * (exclusive) and the heights of the spacers above and below them. `start` is always even, so a
+ * striped table keeps its stripes on the same rows while the window moves.
+ * @param box
+ */
+export declare function virtualRange({ scrollTop, viewport, rowHeight, count, overscan, }: {
+    scrollTop: number;
+    viewport: number;
+    rowHeight: number;
+    count: number;
+    overscan?: number;
+}): {
+    start: number;
+    end: number;
+    before: number;
+    after: number;
+};
+/**
+ * The column widths a person set on this table, remembered in this browser by `viewKey`. Separate from
+ * the `wui-view:` entry (hidden columns and sort), which its writers replace whole. Storage can be
+ * missing or throw (private mode), so a failure reads as nothing remembered.
+ * @param viewKey
+ */
+export declare function readColumnWidths(viewKey: string | null): Record<string, number>;
+/** Remembers `widths` for `viewKey`; an empty object forgets them. */
+export declare function writeColumnWidths(viewKey: string | null, widths: Record<string, number>): void;
+/**
+ * The offset variable a pinned cell reads: `--wui-pin-start-<n>` for the n-th start-pinned column,
+ * counted from the start, and `--wui-pin-end-<n>` counted from the end. The table holds the values.
+ */
+export declare const pinOffsetVar: (side: string, ordinal: number) => string;
+/** The custom property a pinned cell sets; the theme reads it as the cell's inline-start or inline-end offset. */
+export declare const PIN_AT_VAR = "--wui-pin-at";
+/** The value of a pinned cell's PIN_AT_VAR: a reference to the table's offset, so a row rendered later picks it up. */
+export declare const pinAtValue: (side: string, ordinal: number) => string;
+export type PinPlan = {
+    side: "start" | "end";
+    ordinal: number;
+    edge: boolean;
+};
+/**
+ * Plans the pinned columns of a header row from each cell's side (`"start"`, `"end"` or null):
+ * for each column its side, ordinal and whether it is the edge (the last start-pinned or the first
+ * end-pinned column, which draws the scroll shadow). The select and expand columns before a
+ * start-pinned column pin with it.
+ * @param sides
+ */
+export declare function planPins(sides: readonly (string | null)[]): (PinPlan | null)[];
+/** The classes a pinned cell carries for its plan entry. */
+export declare const pinClasses: (pin: PinPlan | null | undefined) => string;
+/** A reorder animates only up to this many rows; past it, measuring and moving every row costs more than the cue gives. */
+export declare const ROW_MOVE_LIMIT = 200;
+/** How long a moved row takes to glide to its new place. */
+export declare const ROW_MOVE_MS = 220;
+/**
+ * Where each shown row sits now, for playRowMoves after a reorder. offsetTop is measured from the table,
+ * so neither the scroll position nor a move still running changes it. Null past ROW_MOVE_LIMIT rows.
+ * @param rows
+ */
+export declare function measureRows(rows: Iterable<HTMLTableRowElement>): Map<string | HTMLTableRowElement, number> | null;
+/**
+ * Glides each row that moved from where `before` saw it to where it is now (a FLIP move, run by the
+ * browser's animation engine, so nothing is left on the row afterwards). Does nothing under reduced
+ * motion or past ROW_MOVE_LIMIT rows. Returns how many rows move.
+ * @param rows
+ * @param before
+ */
+export declare function playRowMoves(rows: Iterable<HTMLTableRowElement>, before: Map<string | HTMLTableRowElement, number> | null): number;
+/**
+ * Whether the rows in both key lists changed order: a sort or a reorder. A row added or removed alone
+ * is not a reorder, so an optimistic row arriving does not make the others glide.
+ * @param before
+ * @param after
+ */
+export declare function rowOrderChanged(before: readonly unknown[] | null, after: readonly unknown[] | null): boolean;
+/** The save states a row shows: `saving` while its add or change is on the way, `error` once it failed. */
+export declare const ROW_SAVE_STATES: string[];
+type RowSave = {
+    state: string | null;
+    label: string;
+    message?: string;
+};
+/** The row attribute that carries its save state. */
+export declare const ROW_SAVE_ATTR = "data-wui-save-state";
+/** The line under a failed row's identity cell that says why. */
+export declare const ROW_SAVE_ERROR_CLASS = "wui-row-save-error";
+/** A row's identity cell: its `.wui-name-cell`, else its first cell after the select and expand cells. */
+export declare const identityCell: (row: HTMLTableRowElement) => HTMLTableCellElement | null;
+/** What a row is called in an announcement: its `.u-name`, else its identity cell's text, without an error line. */
+export declare function rowLabel(row: HTMLTableRowElement): string;
+/**
+ * Shows a row's save state the way React AppDataTable renders it: `saving` sets aria-busy, `error` puts
+ * `message` on a line under the identity cell, and null clears both.
+ * @param row
+ * @param state
+ * @param message
+ */
+export declare function setRowSaveState(row: HTMLTableRowElement, state: string | null, message?: string): void;
+/**
+ * The rows that left the saving state between two passes, keyed alike: saved when they no longer show a
+ * state, failed when they show `error`. A row that disappeared (an added row replaced by the server's,
+ * under a new key) is neither, so the page's own answer speaks for it.
+ * @param before
+ * @param after
+ */
+export declare function settledRows(before: Map<unknown, RowSave> | null, after: Map<unknown, RowSave>): {
+    label: string;
+    ok: boolean;
+    message: string;
+}[];
+/** The polite announcement for rows that settled: "Ana Rao saved.", "3 rows saved." or "Ana Rao was not saved. <reason>". */
+export declare function saveOutcomeText(settled: readonly {
+    label: string;
+    ok: boolean;
+    message?: string;
+}[]): string;
+export {};

package/types/datePresets.d.ts

@@ -0,0 +1,19 @@
+export declare const PRESET_NAMES: readonly ["today", "yesterday", "last7Days", "last30Days", "thisMonth", "lastMonth", "thisFinancialYear"];
+export type PresetName = (typeof PRESET_NAMES)[number];
+export interface Preset {
+    label: string;
+    start: string;
+    end: string;
+}
+export interface PresetOptions {
+    timeZone?: string;
+    financialYearStart?: number;
+}
+/** One named preset as { label, start, end }; null for a name that is not one of PRESET_NAMES. */
+export declare function resolvePreset(name: string, now?: Date, { timeZone, financialYearStart }?: PresetOptions): Preset | null;
+/**
+ * The `presets` attribute as resolved presets. Either a comma list of names (`today,last7Days`) or a
+ * JSON array whose items are names or { label, start, end } objects. An item that is neither is
+ * skipped with a console warning.
+ */
+export declare function parsePresets(raw: unknown, now?: Date, options?: PresetOptions): Preset[];

package/types/defaultCountry.d.ts

@@ -0,0 +1,3 @@
+export declare function countryForTimeZone(zone: string | undefined): string | null;
+export declare function countryForLanguage(tag: string | undefined): string | null;
+export declare function detectCountry(): string | null;

package/types/defineElement.d.ts

@@ -0,0 +1,6 @@
+import type { WuiElementTagMap } from "./globals.ts";
+/**
+ * Registers a custom element once; a second registration of the same tag is a no-op.
+ * Rescues properties set on an element before its definition arrived.
+ */
+export declare function defineElement<K extends keyof WuiElementTagMap>(name: K, ctor: new () => WuiElementTagMap[K]): void;

package/types/devWarn.d.ts

@@ -0,0 +1,2 @@
+export declare function devWarn(message: string, ...optionalParams: unknown[]): void;
+export declare function devError(message: unknown, ...optionalParams: unknown[]): void;

package/types/dom.d.ts

@@ -0,0 +1,8 @@
+type ElementClass<T extends Element> = abstract new (...args: never[]) => T;
+/** The value, or a thrown Error with `message` when it is null or undefined. */
+export declare function must<T>(value: T | null | undefined, message: string): T;
+/** `value` checked to be a `type`, or a thrown TypeError with `message`. */
+export declare function elementOf<T extends Element>(value: unknown, type: ElementClass<T>, message: string): T;
+/** The closest ancestor-or-self of `target` matching `selector`, or null when `target` is not an Element. */
+export declare function closestOf(target: EventTarget | null, selector: string): Element | null;
+export {};

package/types/drawerSnap.d.ts

@@ -0,0 +1,24 @@
+export declare const DEFAULT_SNAP_POINTS: number[];
+export declare const FLICK_VELOCITY = 0.5;
+export interface ResolveSnapArgs {
+    points: number[];
+    index: number;
+    visible: number;
+    velocity: number;
+    canDismiss: boolean;
+}
+/**
+ * Reads snap points from a comma list ("30,60,95") or an array into ascending, de-duplicated
+ * percentages between 10 and 100. Anything unusable gives the default points.
+ */
+export declare function parseSnapPoints(value: unknown, fallback?: number[]): number[];
+/**
+ * Where a released drag lands: an index into `points`, or -1 to dismiss.
+ *
+ * @param args.points Ascending snap percentages.
+ * @param args.index The point the sheet was resting on when the drag began.
+ * @param args.visible The percentage of the viewport the sheet shows at release.
+ * @param args.velocity Pixels per millisecond, positive downwards.
+ * @param args.canDismiss False when the sheet cannot be dragged away.
+ */
+export declare function resolveSnap(args: ResolveSnapArgs): number;

package/types/elementBase.d.ts

@@ -0,0 +1,2 @@
+export declare const NO_DOM_MESSAGE = "@webority/ui-elements needs a browser DOM; import its types or helpers entry on the server";
+export declare const ElementBase: typeof HTMLElement;

package/types/elementRegistry.d.ts

@@ -0,0 +1,5 @@
+import type { WuiElementTagMap } from "./globals.ts";
+/** Whether the element is registered; false where there is no registry, as in a server render. */
+export declare function isElementDefined(tag: keyof WuiElementTagMap): boolean;
+/** Settles once the element is registered. Browser only: call it after the element's entry was imported. */
+export declare function whenElementDefined(tag: keyof WuiElementTagMap): Promise<void>;

package/types/elements/carousel.d.ts

@@ -0,0 +1,2 @@
+import { WuiCarousel } from "../WuiCarousel.ts";
+export { WuiCarousel };

package/types/elements/code-block.d.ts

@@ -0,0 +1,2 @@
+import { WuiCodeBlock } from "../WuiCodeBlock.ts";
+export { WuiCodeBlock };

package/types/elements/command-palette.d.ts

@@ -0,0 +1,2 @@
+import { WuiCommandPalette } from "../WuiCommandPalette.ts";
+export { WuiCommandPalette };

package/types/elements/comment-thread.d.ts

@@ -0,0 +1,4 @@
+import { COMMENT_INTENTS, COMMENT_REACTIONS, COMMENT_TEXT } from "../commentText.ts";
+import { WuiCommentThread } from "../WuiCommentThread.ts";
+import "./mention-input.ts";
+export { COMMENT_INTENTS, COMMENT_REACTIONS, COMMENT_TEXT, WuiCommentThread };

package/types/elements/consent-banner.d.ts

@@ -0,0 +1,2 @@
+import { WuiConsentBanner } from "../WuiConsentBanner.ts";
+export { WuiConsentBanner };

package/types/elements/context-menu.d.ts

@@ -0,0 +1,2 @@
+import { WuiContextMenu } from "../WuiContextMenu.ts";
+export { WuiContextMenu };

package/types/elements/data-table.d.ts

@@ -0,0 +1,3 @@
+import { WuiDataTable } from "../WuiDataTable.ts";
+export { COLUMN_MAX_WIDTH, COLUMN_MIN_WIDTH, clampColumnWidth, DATA_TABLE_TEXT, groupCount, groupItems, identityCell, measureRows, PIN_AT_VAR, PIN_SIDES, pinAtValue, pinClasses, pinOffsetVar, planPins, playRowMoves, RESIZE_STEP, RESIZE_STEP_LARGE, ROW_HEIGHTS, ROW_MOVE_LIMIT, ROW_MOVE_MS, ROW_SAVE_ATTR, ROW_SAVE_ERROR_CLASS, ROW_SAVE_STATES, readColumnWidths, rowLabel, rowOrderChanged, saveOutcomeText, setRowSaveState, settledRows, VIRTUAL_OVERSCAN, virtualRange, writeColumnWidths, } from "../dataTable.ts";
+export { WuiDataTable };

package/types/elements/date-range.d.ts

@@ -0,0 +1,2 @@
+import { WuiDateRange } from "../WuiDateRange.ts";
+export { WuiDateRange };

package/types/elements/datepicker.d.ts

@@ -0,0 +1,2 @@
+import { WuiDatePicker } from "../WuiDatePicker.ts";
+export { WuiDatePicker };

package/types/elements/dock.d.ts

@@ -0,0 +1,2 @@
+import { WuiDock } from "../WuiDock.ts";
+export { WuiDock };

package/types/elements/drawer.d.ts

@@ -0,0 +1,2 @@
+import { WuiDrawer } from "../WuiDrawer.ts";
+export { WuiDrawer };

package/types/elements/filter-popover.d.ts

@@ -0,0 +1,2 @@
+import { FILTER_POPOVER_MAX_CHIPS } from "../filterPopover.ts";
+export { FILTER_POPOVER_MAX_CHIPS };

package/types/elements/hover-card.d.ts

@@ -0,0 +1,2 @@
+import { WuiHoverCard } from "../WuiHoverCard.ts";
+export { WuiHoverCard };

package/types/elements/image-crop.d.ts

@@ -0,0 +1,2 @@
+import { WuiImageCrop } from "../WuiImageCrop.ts";
+export { WuiImageCrop };

package/types/elements/inline-edit.d.ts

@@ -0,0 +1,3 @@
+import { INLINE_EDIT_SAVED_MS, INLINE_EDIT_TEXT, INLINE_EDIT_TYPES, inlineEditText } from "../inlineEditText.ts";
+import { WuiInlineEdit } from "../WuiInlineEdit.ts";
+export { INLINE_EDIT_SAVED_MS, INLINE_EDIT_TEXT, INLINE_EDIT_TYPES, inlineEditText, WuiInlineEdit };

package/types/elements/kanban.d.ts

@@ -0,0 +1,2 @@
+export * from "../kanban.ts";
+export * from "../kanbanModel.ts";

package/types/elements/lead-popup.d.ts

@@ -0,0 +1,2 @@
+import { WuiLeadPopup } from "../WuiLeadPopup.ts";
+export { WuiLeadPopup };

package/types/elements/lightbox.d.ts

@@ -0,0 +1,2 @@
+import { WuiLightbox } from "../WuiLightbox.ts";
+export { WuiLightbox };

package/types/elements/markdown.d.ts

@@ -0,0 +1,2 @@
+import { WuiMarkdown } from "../WuiMarkdown.ts";
+export { WuiMarkdown };

package/types/elements/mention-input.d.ts

@@ -1,5 +1,3 @@
-export type MentionSegment = { text: string } | { id: string; label: string };
-
-export function parseMentionValue(value: string): MentionSegment[];
-
-export function mentionedIds(value: string): string[];
+import { MENTION_ID_PATTERN, mentionLabel, mentionTextFromValue, mentionValueFromText } from "../mentionText.ts";
+import { MENTION_MAX_QUERY, MENTION_MAX_RESULTS, MENTION_TEXT, WuiMentionInput } from "../WuiMentionInput.ts";
+export { MENTION_ID_PATTERN, MENTION_MAX_QUERY, MENTION_MAX_RESULTS, MENTION_TEXT, mentionLabel, mentionTextFromValue, mentionValueFromText, WuiMentionInput, };

package/types/elements/navigation-menu.d.ts

@@ -0,0 +1,2 @@
+import { WuiNavigationMenu } from "../WuiNavigationMenu.ts";
+export { WuiNavigationMenu };

package/types/elements/notification-center.d.ts

@@ -0,0 +1,2 @@
+import { WuiNotificationCenter } from "../WuiNotificationCenter.ts";
+export { WuiNotificationCenter };

package/types/elements/onboarding-checklist.d.ts

@@ -0,0 +1,2 @@
+import { WuiOnboardingChecklist } from "../WuiOnboardingChecklist.ts";
+export { WuiOnboardingChecklist };

package/types/elements/org-tree.d.ts

@@ -0,0 +1,2 @@
+import { WuiOrgTree } from "../WuiOrgTree.ts";
+export { WuiOrgTree };

package/types/elements/otp.d.ts

@@ -0,0 +1,2 @@
+import { WuiOtp } from "../WuiOtp.ts";
+export { WuiOtp };

package/types/elements/overflow.d.ts

@@ -0,0 +1,2 @@
+import { WuiOverflow } from "../WuiOverflow.ts";
+export { WuiOverflow };

package/types/elements/phone.d.ts

@@ -0,0 +1,2 @@
+import { WuiPhone } from "../WuiPhone.ts";
+export { WuiPhone };

package/types/elements/rating.d.ts

@@ -0,0 +1,2 @@
+import { WuiRating } from "../WuiRating.ts";
+export { WuiRating };

package/types/elements/record-pager.d.ts

@@ -0,0 +1,2 @@
+import { WuiRecordPager } from "../WuiRecordPager.ts";
+export { WuiRecordPager };

package/types/elements/relative-time.d.ts

@@ -0,0 +1,3 @@
+import { WuiRelativeTime } from "../WuiRelativeTime.ts";
+export { formatRelativeTime, relativeTimeTitle } from "../relativeTime.ts";
+export { WuiRelativeTime };

package/types/elements/resizable.d.ts

@@ -0,0 +1,2 @@
+import { WuiResizable } from "../WuiResizable.ts";
+export { WuiResizable };

package/types/elements/rolling-number.d.ts

@@ -0,0 +1,2 @@
+import { WuiRollingNumber } from "../WuiRollingNumber.ts";
+export { WuiRollingNumber };

package/types/elements/saved-views.d.ts

@@ -0,0 +1,2 @@
+import { WuiSavedViews } from "../WuiSavedViews.ts";
+export { WuiSavedViews };

package/types/elements/select.d.ts

@@ -0,0 +1,2 @@
+import { WuiSelect } from "../WuiSelect.ts";
+export { WuiSelect };

package/types/elements/shortcuts.d.ts

@@ -0,0 +1,2 @@
+import { WuiShortcuts } from "../WuiShortcuts.ts";
+export { WuiShortcuts };

package/types/elements/show-more.d.ts

@@ -0,0 +1,2 @@
+import { WuiShowMore } from "../WuiShowMore.ts";
+export { WuiShowMore };

package/types/elements/slider.d.ts

@@ -0,0 +1,2 @@
+import { WuiSlider } from "../WuiSlider.ts";
+export { WuiSlider };

package/types/elements/sortable.d.ts

@@ -0,0 +1,2 @@
+import { WuiSortable } from "../WuiSortable.ts";
+export { WuiSortable };

package/types/elements/status-icon.d.ts

@@ -0,0 +1 @@
+export { STATUS_TONES, WuiStatusIcon } from "../statusIcons.ts";

package/types/elements/timepicker.d.ts

@@ -0,0 +1,2 @@
+import { WuiTimePicker } from "../WuiTimePicker.ts";
+export { WuiTimePicker };

package/types/elements/tour.d.ts

@@ -1,6 +1 @@
-export interface LocalSeenStore {
-    isSeen: (tourId: string) => Promise<boolean>;
-    markSeen: (tourId: string, outcome?: "finished" | "skipped") => Promise<void>;
-}
-
-export function createLocalSeenStore(prefix?: string, storage?: Storage): LocalSeenStore;
+export { WuiTour } from "../WuiTour.ts";

package/types/elements/tree.d.ts

@@ -0,0 +1,2 @@
+import { WuiTree } from "../WuiTree.ts";
+export { WuiTree };

package/types/elements/truncate.d.ts

@@ -0,0 +1,2 @@
+import { WuiTruncate } from "../WuiTruncate.ts";
+export { WuiTruncate };

package/types/elements/whats-new.d.ts

@@ -0,0 +1,2 @@
+import { WHATS_NEW_READ_EVENT, WuiWhatsNew } from "../WuiWhatsNew.ts";
+export { WHATS_NEW_READ_EVENT, WuiWhatsNew };

package/types/elements/wizard.d.ts

@@ -0,0 +1,3 @@
+import { WuiWizard } from "../WuiWizard.ts";
+import { WuiWizardStep } from "../WuiWizardStep.ts";
+export { WuiWizard, WuiWizardStep };

package/types/fieldState.d.ts

@@ -0,0 +1,4 @@
+export declare const BUSY_CLASS = "wui-field-busy";
+export declare const isReadOnly: (host: Element) => boolean;
+export declare const isInert: (host: Element) => boolean;
+export declare function syncFieldState(host: Element, control: Element | null | undefined): void;

package/types/fileDrop.d.ts

@@ -0,0 +1,31 @@
+export interface FileDropRules {
+    accept?: string;
+    maxSizeMb?: number;
+    multiple?: boolean;
+}
+export interface FileDropRejection {
+    file: File;
+    message: string;
+}
+export interface FileDropResult {
+    files: File[];
+    rejections: FileDropRejection[];
+}
+/**
+ * The type and size checks every upload part applies to dropped or chosen files (validateFile's rules).
+ * @param files
+ * @param rules
+ */
+export declare function acceptDroppedFiles(files: FileList | File[] | null | undefined, rules: FileDropRules): FileDropResult;
+/**
+ * Wires drag and drop on target: overClass while files are over it (enter and leave counted, so children do not flicker), the checks on drop.
+ * @param target
+ * @param options
+ * @returns Removes the listeners.
+ */
+export declare function attachFileDrop(target: HTMLElement, options: FileDropRules & {
+    overClass: string;
+    isDisabled?: () => boolean;
+    onFiles: (files: File[]) => void;
+    onReject: (rejection: FileDropRejection) => void;
+}): () => void;

package/types/fileValidation.d.ts

@@ -0,0 +1,47 @@
+export declare const DEFAULT_IMAGE_ACCEPT = "image/png,image/jpeg,image/webp";
+export declare const DEFAULT_MAX_SIZE_MB = 5;
+export interface FileLike {
+    name?: string;
+    url?: string;
+    type?: string;
+}
+/**
+ * Is this an image? Drives whether a picked file shows a thumbnail or a file-type icon.
+ * Accepts a File or a plain name/url string, since an existing attachment carries only a name.
+ * A browser reports an empty `file.type` often enough that extension is the reliable fallback.
+ */
+export declare function isImageFile(input: string | FileLike | null): boolean;
+/**
+ * A file's size as both surfaces write it: whole bytes below 1 KB ("193 B"), so a small file
+ * never reads "0 KB", then one decimal in KB, MB or GB ("2.0 KB", "1.5 MB"). The Razor tag
+ * helper writes the same text for a stored file on the server.
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Is this a PDF? Drives whether a picked file shows a rendered first page. Accepts a File or a
+ * plain name/url string, since an existing attachment carries only a name or a url; a query
+ * string or fragment on a url is ignored.
+ */
+export declare function isPdfFile(input: string | FileLike | null | undefined): boolean;
+/**
+ * "Add an image" vs "Add a file": is every token in an `accept` list an image type?
+ * A mixed or non-image `accept` means the field is a general attachment.
+ */
+export declare function isImageOnlyAccept(accept: string): boolean;
+/** "PNG, JPG or WEBP" (or "PNG, PDF or text file"): the human form of an `accept` list, for hints and error copy. */
+export declare function acceptLabel(accept: string | null | undefined): string;
+/** Does the file satisfy an `accept` list? Matches MIME type, wildcard and extension. */
+export declare function matchesAccept(file: FileLike, accept: string | null | undefined): boolean;
+/**
+ * Validate a picked file. Returns a user-facing message, or null when acceptable.
+ * Both surfaces show this exact string, so the two never disagree about a file.
+ *
+ * An absent `accept` or `maxSizeMb` takes the default. An empty `accept` takes any type, and a
+ * `maxSizeMb` that is not a positive number sets no size limit.
+ */
+export declare function validateFile(file: (FileLike & {
+    size: number;
+}) | null | undefined, opts?: {
+    accept?: string;
+    maxSizeMb?: number | null;
+}): string | null;

package/types/fileViewer.d.ts

@@ -0,0 +1,3 @@
+import type { PdfFirstPageOptions, PdfFirstPageSource } from "./fileViewerPdf.ts";
+export { fileKind, fileNameFromUrl, WuiFileViewer } from "./WuiFileViewer.ts";
+export declare const renderPdfFirstPage: (source: PdfFirstPageSource, options?: PdfFirstPageOptions) => Promise<Blob>;

package/types/fileViewerImage.d.ts

@@ -0,0 +1,69 @@
+export interface ImageShell {
+    host: HTMLElement;
+    center: HTMLElement;
+    end: HTMLElement;
+    body: HTMLElement;
+    name: () => string;
+    print: () => boolean;
+    loaded: (detail: {
+        kind: string;
+        pages: number;
+    }) => void;
+    fail: (error: Error) => void;
+}
+export interface ImageSource {
+    src: string;
+}
+interface ImageSize {
+    width: number;
+    height: number;
+}
+interface PanState {
+    id: number;
+    x: number;
+    y: number;
+    left: number;
+    top: number;
+    active: boolean;
+}
+export declare class ImageView {
+    shell: ImageShell;
+    source: ImageSource;
+    zoom: number | "fit";
+    rotation: number;
+    area: ImageSize;
+    destroyed: boolean;
+    natural: ImageSize;
+    img: HTMLImageElement;
+    zoomOutButton: HTMLButtonElement;
+    zoomButton: HTMLButtonElement;
+    zoomInButton: HTMLButtonElement;
+    scroller: HTMLDivElement;
+    stage: HTMLDivElement;
+    _resizeObserver: ResizeObserver | undefined;
+    _onKeyDown: ((e: KeyboardEvent) => void) | undefined;
+    _printFrame: HTMLIFrameElement | undefined;
+    _lastWheelZoom: number | undefined;
+    _pan: PanState | null;
+    /**
+     * @param shell the viewer's parts: { host, start, center, end, body, name, loaded, fail }
+     * @param source
+     */
+    constructor(shell: ImageShell, source: ImageSource);
+    load(): void;
+    destroy(): void;
+    _build(img: HTMLImageElement): void;
+    _turned(): ImageSize;
+    scale(): number;
+    _layout(): void;
+    _zoomStep(dir: number): number | null;
+    _stepZoom(dir: number): void;
+    _setZoom(zoom: number | "fit"): void;
+    _rotate(degrees: number): void;
+    _keyDown(e: KeyboardEvent): void;
+    _panStart(e: PointerEvent): void;
+    _panMove(e: PointerEvent): void;
+    _panEnd(): void;
+    print(): void;
+}
+export {};