package dom

// Element is an opaque handle to a browser DOM element.
type Element int

// Body returns a handle to document.body.
func Body() Element { panic("jsbridge") }

// CreateElement creates a new DOM element with the given tag.
func CreateElement(tag string) Element { panic("jsbridge") }

// CreateTextNode creates a text node.
func CreateTextNode(text string) Element { panic("jsbridge") }

// GetElementById finds an element by its ID attribute.
func GetElementById(id string) Element { panic("jsbridge") }

// QuerySelector finds the first element matching a CSS selector.
func QuerySelector(sel string) Element { panic("jsbridge") }

// AppendChild adds a child element to a parent.
func AppendChild(parent, child Element) { panic("jsbridge") }

// RemoveChild removes a child element from a parent.
func RemoveChild(parent, child Element) { panic("jsbridge") }

// SetAttribute sets an attribute on an element.
func SetAttribute(el Element, name, value string) { panic("jsbridge") }

// SetTextContent sets the text content of an element.
func SetTextContent(el Element, text string) { panic("jsbridge") }

// SetInnerHTML sets the inner HTML of an element.
func SetInnerHTML(el Element, html string) { panic("jsbridge") }

// SetStyle sets a CSS style property on an element.
func SetStyle(el Element, prop, value string) { panic("jsbridge") }

// AddClass adds a CSS class to an element.
func AddClass(el Element, cls string) { panic("jsbridge") }

// RemoveClass removes a CSS class from an element.
func RemoveClass(el Element, cls string) { panic("jsbridge") }

// Focus sets keyboard focus on an element.
func Focus(el Element) { panic("jsbridge") }

// SetProperty sets a JS property on an element.
func SetProperty(el Element, prop, value string) { panic("jsbridge") }

// GetProperty gets a JS property from an element as a string.
func GetProperty(el Element, prop string) string { panic("jsbridge") }

// RegisterCallback registers a Go function as a JS event callback.
// Returns a callback ID for use with AddEventListener.
func RegisterCallback(fn func()) int { panic("jsbridge") }

// ReleaseCallback releases a registered callback.
func ReleaseCallback(id int) { panic("jsbridge") }

// AddEventListener adds an event listener. callbackId is from RegisterCallback.
func AddEventListener(el Element, event string, callbackId int) { panic("jsbridge") }

// AddSelfEventListener adds an event listener that only fires when
// the event target is the element itself, not a descendant.
func AddSelfEventListener(el Element, event string, callbackId int) { panic("jsbridge") }

// AddEnterKeyListener fires callback when Enter is pressed on the element.
func AddEnterKeyListener(el Element, callbackId int) { panic("jsbridge") }

// RemoveEventListener removes an event listener.
func RemoveEventListener(el Element, event string, callbackId int) { panic("jsbridge") }

// RequestAnimationFrame schedules a function to run before the next repaint.
func RequestAnimationFrame(fn func()) { panic("jsbridge") }

// SetTimeout schedules a function to run after ms milliseconds. Returns timer ID.
func SetTimeout(fn func(), ms int) int { panic("jsbridge") }

// ClearTimeout cancels a timer created by SetTimeout.
func ClearTimeout(id int) { panic("jsbridge") }

// FirstChild returns the first child node, or 0 if none.
// May return text nodes — use FirstElementChild for Element-only traversal.
func FirstChild(el Element) Element { panic("jsbridge") }

// FirstElementChild returns the first child that is an Element, or 0 if none.
// Skips text nodes and comments.
func FirstElementChild(el Element) Element { panic("jsbridge") }

// NextSibling returns the next sibling element, or 0 if none.
func NextSibling(el Element) Element { panic("jsbridge") }

// InsertBefore inserts newChild before refChild in parent.
func InsertBefore(parent, newChild, refChild Element) { panic("jsbridge") }

// ReleaseElement releases a DOM element handle.
func ReleaseElement(el Element) { panic("jsbridge") }

// FetchText fetches a URL and calls fn with the response text.
func FetchText(url string, fn func(string)) { panic("jsbridge") }

// FetchRelayInfo fetches NIP-11 relay info document from URL. Adds Accept header.
func FetchRelayInfo(url string, fn func(string)) { panic("jsbridge") }

// IDBGet retrieves a value from IndexedDB by key. Calls fn with "" if not found.
func IDBGet(store, key string, fn func(string)) { panic("jsbridge") }

// IDBPut stores a key-value pair in IndexedDB.
func IDBPut(store, key, value string) { panic("jsbridge") }

// IDBGetAll retrieves all key-value pairs from an IndexedDB store.
// Calls fn once per entry with (key, value). Calls done() when finished.
func IDBGetAll(store string, fn func(string, string), done func()) { panic("jsbridge") }

// PrefersDark returns true if the browser prefers dark color scheme.
func PrefersDark() bool { panic("jsbridge") }

// ConsoleLog logs a message to the browser console.
func ConsoleLog(msg string) { panic("jsbridge") }

// Confirm shows a browser confirm dialog and returns the user's choice.
func Confirm(msg string) bool { panic("jsbridge") }

// PostToSW sends a JSON message string to the service worker controller.
func PostToSW(msg string) { panic("jsbridge") }

// OnSWMessage registers a handler for JSON array messages from the service worker.
// fn receives the JSON-stringified array for each message.
func OnSWMessage(fn func(string)) { panic("jsbridge") }

// PushState pushes a new browser history entry with the given path.
func PushState(path string) { panic("jsbridge") }

// ReplaceState replaces the current browser history entry with the given path.
func ReplaceState(path string) { panic("jsbridge") }

// Back navigates one step back in browser history.
func Back() { panic("jsbridge") }

// LocationReload reloads the current page.
func LocationReload() { panic("jsbridge") }

// HardRefresh clears all SW caches, unregisters service workers, and reloads.
func HardRefresh() { panic("jsbridge") }

// ClearStoragePrefix removes all localStorage keys starting with the given prefix.
func ClearStoragePrefix(prefix string) { panic("jsbridge") }

// TimezoneOffsetSeconds returns the local timezone offset in seconds to add to UTC.
// E.g. UTC+9 returns 32400, UTC-8 returns -28800.
func TimezoneOffsetSeconds() int { panic("jsbridge") }

// ReadClipboard reads text from the clipboard. Uses navigator.clipboard.readText()
// if available (secure context), otherwise falls back to prompt().
// Calls fn with the text, or empty string if cancelled/failed.
func ReadClipboard(fn func(string)) { panic("jsbridge") }

// GetPath returns the current location.pathname.
func GetPath() string { panic("jsbridge") }

// Hostname returns the current location.hostname.
func Hostname() string { panic("jsbridge") }

// Port returns the current location.port.
func Port() string { panic("jsbridge") }

// UserAgent returns navigator.userAgent.
func UserAgent() string { panic("jsbridge") }

// OnPopState registers a handler for browser back/forward navigation.
// fn receives the new location.pathname.
func OnPopState(fn func(string)) { panic("jsbridge") }

// PickFileText opens a file picker dialog and reads the selected file as text.
// accept is the file type filter (e.g. ".json" or "application/json").
// Calls fn with the file text content, or empty string if cancelled/error.
func PickFileText(accept string, fn func(string)) { panic("jsbridge") }

// DownloadText triggers a file download with the given text content and filename.
func DownloadText(filename, content, mimeType string) { panic("jsbridge") }

// OnPullRefresh registers a handler that fires when the user pulls to refresh
// at the top of a scrollable element (wheel or touch). indicator is shown during pull.
func OnPullRefresh(el Element, indicator Element, fn func()) { panic("jsbridge") }

// NowSeconds returns the current Unix timestamp in seconds.
func NowSeconds() int64 { panic("jsbridge") }