@simplysm/core-browser 13.0.100 → 14.0.4

package/docs/element-extensions.md

@@ -1,134 +0,0 @@
-# Element Extensions
-
-Extensions added to the `Element.prototype` via side-effect import. These methods are available on all `Element` instances when `@simplysm/core-browser` is imported.
-
-```typescript
-import "@simplysm/core-browser";
-```
-
-## `ElementBounds`
-
-Element bounds information type returned by `getBounds`.
-
-```typescript
-interface ElementBounds {
-  /** Element to be measured */
-  target: Element;
-  /** Top position relative to viewport */
-  top: number;
-  /** Left position relative to viewport */
-  left: number;
-  /** Element width */
-  width: number;
-  /** Element height */
-  height: number;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `target` | `Element` | Element to be measured |
-| `top` | `number` | Top position relative to viewport |
-| `left` | `number` | Left position relative to viewport |
-| `width` | `number` | Element width |
-| `height` | `number` | Element height |
-
-## `Element.findAll`
-
-Find all child elements matching a CSS selector.
-
-```typescript
-findAll<TEl extends Element = Element>(selector: string): TEl[];
-```
-
-Returns an empty array if the selector is empty.
-
-## `Element.findFirst`
-
-Find first element matching a CSS selector.
-
-```typescript
-findFirst<TEl extends Element = Element>(selector: string): TEl | undefined;
-```
-
-Returns `undefined` if the selector is empty or no match is found.
-
-## `Element.prependChild`
-
-Insert element as first child.
-
-```typescript
-prependChild<TEl extends Element>(child: TEl): TEl;
-```
-
-## `Element.getParents`
-
-Get all parent elements in order of proximity (from closest to farthest).
-
-```typescript
-getParents(): Element[];
-```
-
-## `Element.findFocusableParent`
-
-Find first focusable parent element (using tabbable library).
-
-```typescript
-findFocusableParent(): HTMLElement | undefined;
-```
-
-## `Element.findFirstFocusableChild`
-
-Find first focusable child element (using tabbable library). Uses a TreeWalker for traversal.
-
-```typescript
-findFirstFocusableChild(): HTMLElement | undefined;
-```
-
-## `Element.isOffsetElement`
-
-Check if element is an offset parent (`position: relative | absolute | fixed | sticky`).
-
-```typescript
-isOffsetElement(): boolean;
-```
-
-## `Element.isVisible`
-
-Check if element is visible on screen. Checks existence of clientRects, `visibility: hidden`, and `opacity: 0`.
-
-```typescript
-isVisible(): boolean;
-```
-
-## `copyElement`
-
-Copy element content to clipboard. Use as a copy event handler. Finds the first `input`/`textarea` within the target element and copies its value.
-
-```typescript
-function copyElement(event: ClipboardEvent): void;
-```
-
-## `pasteToElement`
-
-Paste clipboard content to element. Use as a paste event handler. Finds the first `input`/`textarea` within the target element and replaces its entire value with clipboard content. Does not consider cursor position or selection.
-
-```typescript
-function pasteToElement(event: ClipboardEvent): void;
-```
-
-## `getBounds`
-
-Get bounds information for multiple elements using IntersectionObserver.
-
-```typescript
-async function getBounds(els: Element[], timeout?: number): Promise<ElementBounds[]>;
-```
-
-**Parameters:**
-- `els` -- Array of target elements
-- `timeout` -- Timeout in milliseconds (default: `5000`)
-
-**Throws:** `TimeoutError` if no response within the timeout duration.
-
-Results are returned sorted in input order, with duplicates removed.

package/docs/html-element-extensions.md

@@ -1,56 +0,0 @@
-# HTMLElement Extensions
-
-Extensions added to the `HTMLElement.prototype` via side-effect import. These methods are available on all `HTMLElement` instances when `@simplysm/core-browser` is imported.
-
-```typescript
-import "@simplysm/core-browser";
-```
-
-## `HTMLElement.repaint`
-
-Force repaint by triggering reflow. Internally accesses `offsetHeight` which triggers forced synchronous layout in the browser.
-
-```typescript
-repaint(): void;
-```
-
-## `HTMLElement.getRelativeOffset`
-
-Calculate relative position based on a parent element for CSS positioning.
-
-```typescript
-getRelativeOffset(parent: HTMLElement | string): { top: number; left: number };
-```
-
-Returns document-based coordinates including `window.scrollX/Y` that can be directly used in CSS `top`/`left` properties.
-
-**Parameters:**
-- `parent` -- Parent element or CSS selector to use as reference (e.g., `document.body`, `".container"`)
-
-**Throws:** `ArgumentError` if parent element cannot be found.
-
-**Factors included in calculation:**
-- Viewport-relative position (`getBoundingClientRect`)
-- Document scroll position (`window.scrollX/Y`)
-- Parent element internal scroll (`parentEl.scrollTop/Left`)
-- Border thickness of intermediate elements
-- CSS transform transformations
-
-**Common use cases:**
-- Position dropdowns, popups after appending to `document.body`
-- Works correctly on scrolled pages
-
-## `HTMLElement.scrollIntoViewIfNeeded`
-
-Scroll to make target visible if hidden by offset area (e.g., fixed header/column). Only handles cases where target extends beyond top/left boundaries of the scroll area. For downward/rightward scrolling, relies on browser's default focus scroll behavior. Typically used with focus events on tables with fixed headers or columns.
-
-```typescript
-scrollIntoViewIfNeeded(
-  target: { top: number; left: number },
-  offset?: { top: number; left: number },
-): void;
-```
-
-**Parameters:**
-- `target` -- Target position within container (`offsetTop`, `offsetLeft`)
-- `offset` -- Size of area that must not be obscured (e.g., fixed header height, fixed column width). Defaults to `{ top: 0, left: 0 }`.

package/docs/utilities.md

@@ -1,71 +0,0 @@
-# Utilities
-
-Standalone utility functions for browser-side operations.
-
-```typescript
-import { downloadBlob, fetchUrlBytes, openFileDialog } from "@simplysm/core-browser";
-```
-
-## `downloadBlob`
-
-Download a Blob as a file by creating a temporary object URL and clicking a hidden link.
-
-```typescript
-function downloadBlob(blob: Blob, fileName: string): void;
-```
-
-**Parameters:**
-- `blob` -- Blob object to download
-- `fileName` -- File name to save as
-
-## `DownloadProgress`
-
-Download progress information used by `fetchUrlBytes`.
-
-```typescript
-interface DownloadProgress {
-  receivedLength: number;
-  contentLength: number;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `receivedLength` | `number` | Number of bytes received so far |
-| `contentLength` | `number` | Total content length from `Content-Length` header |
-
-## `fetchUrlBytes`
-
-Download binary data from a URL with optional progress callback support.
-
-```typescript
-async function fetchUrlBytes(
-  url: string,
-  options?: { onProgress?: (progress: DownloadProgress) => void },
-): Promise<Uint8Array>;
-```
-
-**Parameters:**
-- `url` -- URL to download from
-- `options.onProgress` -- Progress callback function
-
-When `Content-Length` is known, pre-allocates memory for efficiency. For chunked encoding (unknown length), collects chunks and merges them.
-
-**Throws:** `Error` if the download fails or the response body is not readable.
-
-## `openFileDialog`
-
-Programmatically open a file selection dialog.
-
-```typescript
-function openFileDialog(options?: {
-  accept?: string;
-  multiple?: boolean;
-}): Promise<File[] | undefined>;
-```
-
-**Parameters:**
-- `options.accept` -- File type filter (e.g., `".csv"`, `"image/*"`)
-- `options.multiple` -- Allow multiple file selection (default: `false`)
-
-**Returns:** Array of selected files, or `undefined` if the dialog is cancelled.