spark_web 1.0.0-alpha.10

Server-safe Web API abstraction for Dart. Mirrors the MDN Web API with identical naming so developers can rely on MDN documentation. Works on both the Dart VM (server) and dart2js (browser).

Changelog

All notable changes to spark_web will be documented in this file.

1.0.0-alpha.10

Added

• Feat: Added Element.closest() method support for both browser and server.
• Feat: Added complete Permissions API support (permissions.dart).
  • PermissionState enum (granted, denied, prompt).
  • PermissionName enum with constants for all standard permissions (geolocation, notifications, push, persistent-storage, clipboard-read, clipboard-write, camera, microphone, background-fetch, background-sync).
  • PermissionDescriptor base class and specialized descriptors: PushPermissionDescriptor, MidiPermissionDescriptor, DevicePermissionDescriptor.
  • PermissionStatus abstract interface with state, name, and onchange.
  • Permissions abstract interface with query().
  • Navigator.permissions getter for both browser and server.
  • Server implementation returns PermissionState.prompt for all queries.
  • Browser implementation wraps native window.navigator.permissions API.

1.0.0-alpha.9

Added

• Feat: Greatly improved HTMLInputElement support by adding specialized interfaces for all input types (HTMLTextInputElement, HTMLNumericInputElement, HTMLCheckableInputElement, HTMLFileInputElement, and HTMLButtonInputElement).
• Feat: Added support for ValidityState and constraint validation methods on input elements.
• Feat: Added HTMLDataListElement and support for the list property on input elements.
• Feat: Added File and FileList interfaces with platform-appropriate implementations.
• Feat: Added Blob interface and createBlob factory function. File now extends Blob.
• Feat: Added many missing properties to HTMLInputElement including labels, defaultValue, selectionStart/End, valueAsNumber/Date, etc.

1.0.0-alpha.8

Added

• Feat: Added specialized event factory functions: createMouseEvent, createKeyboardEvent, createFocusEvent, createInputEvent, createWheelEvent, createPointerEvent, createTouchEvent, createDragEvent, createAnimationEvent, createTransitionEvent, and createCustomEvent.
• Feat: Added missing browser-side element wrappers for HTMLParagraphElement, HTMLHeadingElement, HTMLUListElement, HTMLPreElement, HTMLHRElement, and HTMLBRElement.
• Feat: Improved ServerDocument.createElement to return correctly typed element instances for almost all HTML tags.
• Feat: Added missing server-side specialized event implementations.

Changed

• Refactor: Refined HTMLTableElement, HTMLTableSectionElement, and HTMLTableRowElement interfaces to use more specific return types matching the MDN Web API.

Fixed

• Tests: Achieved 100% test coverage across all modules.
• Fixed an issue where BrowserHTMLMeterElement.value could be clamped incorrectly if set before max.

1.0.0-alpha.7

Added

• Feat: Implemented adoptedStyleSheets getter for ShadowRoot on browser. This allows reading back applied stylesheets, which is necessary for correct hydration of styled components.

Fixed

• Improved stability of node wrapping by ensuring consistent wrapper types for various element classes.

1.0.0-alpha.6

Added

• Feat: Added idiomatic Dart API for Geolocation.
  • Added Future<GeolocationPosition> getPosition([PositionOptions? options]).
  • Added Stream<GeolocationPosition> onPositionChanged([PositionOptions? options]).
  • Implementation provided for both Browser and Server (server returns appropriate errors).

1.0.0-alpha.5

Added

• Feat: Added complete Notification Web API support (notification.dart).
  • Notification abstract interface with properties: title, body, tag, icon, dir, lang, badge, requireInteraction, silent, timestamp, data, and close().
  • NotificationOptions data class for configuring notifications.
  • NotificationPermission enum (granted, denied, defaultValue).
  • NotificationDirection enum (auto, ltr, rtl).
  • createNotification() factory function (platform-aware).
  • requestNotificationPermission() async permission request.
  • notificationPermission getter for current permission state.
  • notificationMaxActions getter.
  • Server implementation returns safe defaults; browser implementation wraps the native window.Notification API.
• Added notification example page in the example app (/notification) for manual testing of the Notification API.

1.0.0-alpha.4

Added

• Added BrowserHTMLDivElement and BrowserHTMLSpanElement wrappers so that createElement('div') and createElement('span') return the correct typed wrappers.
• Feat: Added HTMLCollection support and Element.children.
• Feat: Added activeElement to Document.
• Feat: Added focus() and blur() to HTMLElement.

1.0.0-alpha.3

Fixed

• Fixed Event.target, Event.currentTarget, FocusEvent.relatedTarget, and Touch.target returning generic EventTarget wrappers instead of specific Node wrappers (like Element). This ensures that is Node checks work correctly on event targets.

1.0.0-alpha.2

Changed

• Updated Node.contains to accept EventTarget? instead of Node?. This fixes issues where event.target could not be passed directly to contains.

1.0.0-alpha.1

Initial release of the server-safe Web API abstraction.

Added

Core types (core.dart)

• EventTarget — addEventListener, removeEventListener, dispatchEvent
• Event — type, target, currentTarget, preventDefault, stopPropagation
• MouseEvent — clientX/Y, pageX/Y, screenX/Y, button, modifier keys
• KeyboardEvent — key, code, repeat, location, modifier keys
• InputEvent — data, inputType, isComposing
• Node — Full tree traversal, appendChild, removeChild, insertBefore, replaceChild, cloneNode, contains
• NodeList — length, item()
• MutationObserver — observe, disconnect, takeRecords
• MutationRecord — type, target, addedNodes, removedNodes, attributeName, oldValue
• MutationObserverInit — configuration data class

DOM types (dom.dart)

• Element — tagName, id, className, innerHTML, outerHTML, classList, attributes, querySelector, querySelectorAll, getAttribute, setAttribute, removeAttribute, hasAttribute, remove, append
• HTMLElement — innerText, hidden, title, style, shadowRoot, attachShadow
• HTMLDivElement, HTMLSpanElement, HTMLParagraphElement
• HTMLInputElement — value, type, placeholder, disabled, checked, name
• HTMLTextAreaElement — value, placeholder, disabled, rows, cols
• HTMLButtonElement — disabled, type
• HTMLSelectElement — value, selectedIndex, disabled
• HTMLOptionElement — value, text, selected
• HTMLAnchorElement — href, target
• HTMLImageElement — src, alt, width, height
• HTMLFormElement — action, method, submit(), reset(), reportValidity()
• HTMLLabelElement — htmlFor
• HTMLTemplateElement — content
• DocumentFragment — querySelector, querySelectorAll
• ShadowRoot — host, mode, adoptedStyleSheets, firstElementChild
• Document — createElement, createElementNS, createTextNode, createComment, createDocumentFragment, getElementById, querySelector, querySelectorAll, documentElement, body, head
• Text — data, wholeText
• Comment — data

Collection types (collections.dart)

• DOMTokenList — add, remove, toggle, contains, replace, item
• NamedNodeMap — item, getNamedItem, removeNamedItem
• Attr — name, value

CSS types (css.dart)

• CSSStyleSheet — replaceSync, replace
• CSSStyleDeclaration — getPropertyValue, setProperty, removeProperty, display, visibility, opacity

Window types (window.dart)

• Window — document, console, navigator, localStorage, sessionStorage, location, history, crypto, performance, customElements, alert, confirm, prompt, setTimeout, setInterval, requestAnimationFrame, btoa, atob
• Storage — getItem, setItem, removeItem, clear, key, length
• Location — href, protocol, host, hostname, port, pathname, search, hash, origin, assign, replace, reload
• History — pushState, replaceState, back, forward, go, state, length
• Navigator — userAgent, language, languages, onLine, clipboard
• Console — log, warn, error, info, debug
• Crypto — randomUUID()
• Performance — now()
• CustomElementRegistry — define, get, upgrade, whenDefined
• Clipboard — readText, writeText

Global singletons

• window — Pre-initialized Window instance
• document — Pre-initialized Document instance
• kIsBrowser — true on browser, false on Dart VM

Factory functions

• createMutationObserver() — Platform-aware constructor
• createEvent() — Platform-aware constructor

Server implementations

• All types are no-ops or provide Dart-native fallbacks
• Storage backed by Map
• Crypto.randomUUID() via dart:math
• btoa/atob via dart:convert
• Performance.now() via Stopwatch
• Clipboard stores text in memory

Browser implementations

• All types wrap package:web DOM objects
• .raw property exposes the native JS object