wuira 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -7,6 +7,22 @@ with the release date and highlight breaking changes explicitly.
 
 ## Unreleased
 
+## 0.1.9 — 2026-10-15
+
+### Added
+
+- Generic `Encoding.Encode` / `Decode` using native CBOR, compression and Base64,
+  with decode size checks. Import formats and schema validation stay in applications.
+- Native `ScrollHost` for clipped, mouse-wheel scrolling inside mounted Cells.
+- Native `TextInput` hosts for copy/paste and text entry inside mounted Cells,
+  including focus selection, Escape callbacks and cleanup.
+
+### Fixed
+
+- `TextInput` passes the required font flags to Forever's native EditBox API.
+- `Window.Open` retains its current content if a replacement fails to render or
+  mount. Header cleanup only stops a drag when the window is actually moving.
+
 ## 0.1.8 — 2026-10-14
 
 ### Added

package/lib/index.d.ts

@@ -3,6 +3,7 @@ import "./console-polyfill";
 export { wuira } from "./wuira";
 export type { CommandCallback } from "./platform/SlashCommands";
 export { AddonSettings } from "./platform/AddonSettings";
+export { Encoding } from "./platform/Encoding";
 export { Spells } from "./Spells";
 export { BlizzardUI } from "./platform/BlizzardUI";
 export { ActionBars } from "./platform/ActionBars";

package/lib/index.lua

@@ -9,6 +9,10 @@ do
     local ____AddonSettings = require("platform.AddonSettings")
     ____exports.AddonSettings = ____AddonSettings.AddonSettings
 end
+do
+    local ____Encoding = require("platform.Encoding")
+    ____exports.Encoding = ____Encoding.Encoding
+end
 do
     local ____Spells = require("Spells")
     ____exports.Spells = ____Spells.Spells

package/lib/platform/Encoding.d.ts

@@ -0,0 +1,6 @@
+/** Native CBOR, compression and Base64 transport for serializable data. */
+export declare class Encoding {
+    static Encode(value: unknown): string;
+    /** Returns unvalidated data; the size bound is also checked after decompression. */
+    static Decode(value: string, maxBytes?: number): unknown;
+}

package/lib/platform/Encoding.lua

@@ -0,0 +1,58 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+-- Lua Library inline imports
+local function __TS__Class(self)
+    local c = {prototype = {}}
+    c.prototype.__index = c.prototype
+    c.prototype.constructor = c
+    return c
+end
+
+local function __TS__NumberIsFinite(value)
+    return type(value) == "number" and value == value and value ~= math.huge and value ~= -math.huge
+end
+-- End of Lua Library inline imports
+local ____exports = {}
+--- Native CBOR, compression and Base64 transport for serializable data.
+____exports.Encoding = __TS__Class()
+local Encoding = ____exports.Encoding
+Encoding.name = "Encoding"
+function Encoding.prototype.____constructor(self)
+end
+function Encoding.Encode(self, value)
+    if C_EncodingUtil == nil then
+        error("Encoding: native codec is unavailable")
+    end
+    local compressed = C_EncodingUtil.CompressString(C_EncodingUtil.SerializeCBOR(value))
+    if compressed == nil then
+        error("Encoding: compression failed")
+    end
+    local encoded = C_EncodingUtil.EncodeBase64(compressed)
+    if encoded == nil then
+        error("Encoding: encoding failed")
+    end
+    return encoded
+end
+function Encoding.Decode(self, value, maxBytes)
+    if maxBytes == nil then
+        maxBytes = 262144
+    end
+    if not __TS__NumberIsFinite(maxBytes) or maxBytes < 1 then
+        error("Encoding: invalid size limit")
+    end
+    if type(value) ~= "string" or issecretvalue(value) or #value > maxBytes then
+        error("Encoding: invalid encoded data")
+    end
+    if C_EncodingUtil == nil then
+        error("Encoding: native codec is unavailable")
+    end
+    local decoded = C_EncodingUtil.DecodeBase64(value)
+    if decoded == nil then
+        error("Encoding: invalid encoding")
+    end
+    local decompressed = C_EncodingUtil.DecompressString(decoded)
+    if decompressed == nil or #decompressed > maxBytes then
+        error("Encoding: invalid or oversized compressed data")
+    end
+    return C_EncodingUtil.DeserializeCBOR(decompressed)
+end
+return ____exports

package/lib/platform/forever.d.ts

@@ -30,14 +30,16 @@ interface wuiraNativeFrame {
     StopMovingOrSizing(): void;
     EnableKeyboard(enabled: boolean): void;
     SetPropagateKeyboardInput(propagate: boolean): void;
-    SetScript(script: "OnClick" | "OnDragStart" | "OnDragStop" | "OnEnter" | "OnLeave", handler: ((this: void, frame: wuiraNativeFrame) => void) | undefined): void;
+    SetScript(script: "OnClick" | "OnDragStart" | "OnDragStop" | "OnEnter" | "OnLeave" | "OnEscapePressed", handler: ((this: void, frame: wuiraNativeFrame) => void) | undefined): void;
     SetScript(script: "OnKeyDown", handler: ((this: void, frame: wuiraNativeFrame, key: string) => void) | undefined): void;
+    SetScript(script: "OnMouseWheel", handler: ((this: void, frame: wuiraNativeFrame, delta: number) => void) | undefined): void;
     GetName(): string | undefined;
     IsProtected?(): boolean;
     GetParent(): wuiraNativeFrame;
     GetNumPoints(): number;
     GetPoint(index: number): wuiraNativeReturns<[wuiraAnchor, wuiraNativeFrame, wuiraAnchor, number, number]>;
     GetScale(): number;
+    SetScale(scale: number): void;
     GetChildren(): wuiraNativeFrame[] & { readonly __tstlMultiReturn: unknown };
     IsMouseOver(): boolean;
     SetFrameStrata(strata: "BACKGROUND" | "LOW" | "MEDIUM" | "HIGH" | "DIALOG" | "FULLSCREEN" | "FULLSCREEN_DIALOG" | "TOOLTIP"): void;
@@ -175,3 +177,12 @@ declare const GetTotemInfo: ((this: void, slot: number) => wuiraNativeReturns<[
     number | undefined, number | undefined, number | undefined,
 ]>) | undefined;
 declare const GetTotemDuration: ((this: void, slot: number) => import("../datasources/TimerSource").NativeDuration) | undefined;
+
+declare const C_EncodingUtil: {
+    SerializeCBOR(this: void, value: unknown): string;
+    DeserializeCBOR(this: void, value: string): unknown;
+    CompressString(this: void, value: string): string | undefined;
+    DecompressString(this: void, value: string): string | undefined;
+    EncodeBase64(this: void, value: string): string | undefined;
+    DecodeBase64(this: void, value: string): string | undefined;
+} | undefined;

package/lib/ui/ScrollHost.d.ts

@@ -0,0 +1,19 @@
+interface NativeScrollFrame extends wuiraNativeFrame {
+    SetScrollChild(child: wuiraNativeFrame): void;
+    UpdateScrollChildRect(): void;
+    GetVerticalScrollRange(): number;
+    GetVerticalScroll(): number;
+    SetVerticalScroll(offset: number): void;
+}
+/** Native clipping and mouse-wheel scrolling for content mounted inside a Cell. */
+export declare class ScrollHost {
+    private readonly onScroll?;
+    readonly Frame: NativeScrollFrame;
+    private disposed;
+    constructor(parent: wuiraNativeFrame, onScroll?: ((offset: number) => void) | undefined);
+    SetContent(content: wuiraNativeFrame, offset?: number): void;
+    ScrollBy(amount: number): void;
+    ScrollTo(offset: number): void;
+    Dispose(): void;
+}
+export {};

package/lib/ui/ScrollHost.lua

@@ -0,0 +1,67 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+-- Lua Library inline imports
+local function __TS__Class(self)
+    local c = {prototype = {}}
+    c.prototype.__index = c.prototype
+    c.prototype.constructor = c
+    return c
+end
+-- End of Lua Library inline imports
+local ____exports = {}
+--- Native clipping and mouse-wheel scrolling for content mounted inside a Cell.
+____exports.ScrollHost = __TS__Class()
+local ScrollHost = ____exports.ScrollHost
+ScrollHost.name = "ScrollHost"
+function ScrollHost.prototype.____constructor(self, parent, onScroll)
+    self.onScroll = onScroll
+    self.disposed = false
+    self.Frame = CreateFrame("ScrollFrame", nil, parent)
+    self.Frame:SetSize(
+        parent:GetWidth(),
+        parent:GetHeight()
+    )
+    self.Frame:SetAllPoints(parent)
+    self.Frame:EnableMouse(true)
+    self.Frame:SetScript(
+        "OnMouseWheel",
+        function(_frame, delta) return self:ScrollBy(-delta * 32) end
+    )
+    self.Frame:Show()
+end
+function ScrollHost.prototype.SetContent(self, content, offset)
+    if offset == nil then
+        offset = 0
+    end
+    self.Frame:SetScrollChild(content)
+    self.Frame:UpdateScrollChildRect()
+    self:ScrollTo(offset)
+end
+function ScrollHost.prototype.ScrollBy(self, amount)
+    self:ScrollTo(self.Frame:GetVerticalScroll() + amount)
+end
+function ScrollHost.prototype.ScrollTo(self, offset)
+    if self.disposed then
+        return
+    end
+    local value = math.max(
+        0,
+        math.min(
+            self.Frame:GetVerticalScrollRange(),
+            offset
+        )
+    )
+    self.Frame:SetVerticalScroll(value)
+    local ____opt_0 = self.onScroll
+    if ____opt_0 ~= nil then
+        ____opt_0(self, value)
+    end
+end
+function ScrollHost.prototype.Dispose(self)
+    if self.disposed then
+        return
+    end
+    self.disposed = true
+    self.Frame:SetScript("OnMouseWheel", nil)
+    self.Frame:Hide()
+end
+return ____exports

package/lib/ui/TextInput.d.ts

@@ -0,0 +1,26 @@
+interface NativeEditBox extends wuiraNativeFrame {
+    SetAutoFocus(value: boolean): void;
+    SetMultiLine(value: boolean): void;
+    SetFont(path: string, size: number, flags: string): boolean;
+    SetTextInsets(left: number, right: number, top: number, bottom: number): void;
+    SetMaxBytes(bytes: number): void;
+    SetText(text: string): void;
+    GetText(): string;
+    HighlightText(): void;
+    SetFocus(): void;
+    ClearFocus(): void;
+}
+/** Native text entry hosted by a mounted Cell. Dispose it in that Cell's onMount cleanup. */
+export declare class TextInput {
+    readonly Frame: NativeEditBox;
+    private disposed;
+    constructor(parent: wuiraNativeFrame, options?: {
+        text?: string;
+        maxBytes?: number;
+        onEscape?: () => void;
+    });
+    get Value(): string;
+    Focus(selectAll?: boolean): void;
+    Dispose(): void;
+}
+export {};

package/lib/ui/TextInput.lua

@@ -0,0 +1,206 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+-- Lua Library inline imports
+local function __TS__Class(self)
+    local c = {prototype = {}}
+    c.prototype.__index = c.prototype
+    c.prototype.constructor = c
+    return c
+end
+
+local function __TS__CloneDescriptor(____bindingPattern0)
+    local value
+    local writable
+    local set
+    local get
+    local configurable
+    local enumerable
+    enumerable = ____bindingPattern0.enumerable
+    configurable = ____bindingPattern0.configurable
+    get = ____bindingPattern0.get
+    set = ____bindingPattern0.set
+    writable = ____bindingPattern0.writable
+    value = ____bindingPattern0.value
+    local descriptor = {enumerable = enumerable == true, configurable = configurable == true}
+    local hasGetterOrSetter = get ~= nil or set ~= nil
+    local hasValueOrWritableAttribute = writable ~= nil or value ~= nil
+    if hasGetterOrSetter and hasValueOrWritableAttribute then
+        error("Invalid property descriptor. Cannot both specify accessors and a value or writable attribute.", 0)
+    end
+    if get or set then
+        descriptor.get = get
+        descriptor.set = set
+    else
+        descriptor.value = value
+        descriptor.writable = writable == true
+    end
+    return descriptor
+end
+
+local __TS__DescriptorGet
+do
+    local getmetatable = _G.getmetatable
+    local ____rawget = _G.rawget
+    function __TS__DescriptorGet(self, metatable, key)
+        while metatable do
+            local rawResult = ____rawget(metatable, key)
+            if rawResult ~= nil then
+                return rawResult
+            end
+            local descriptors = ____rawget(metatable, "_descriptors")
+            if descriptors then
+                local descriptor = descriptors[key]
+                if descriptor ~= nil then
+                    if descriptor.get then
+                        return descriptor.get(self)
+                    end
+                    return descriptor.value
+                end
+            end
+            metatable = getmetatable(metatable)
+        end
+    end
+end
+
+local __TS__DescriptorSet
+do
+    local getmetatable = _G.getmetatable
+    local ____rawget = _G.rawget
+    local rawset = _G.rawset
+    function __TS__DescriptorSet(self, metatable, key, value)
+        while metatable do
+            local descriptors = ____rawget(metatable, "_descriptors")
+            if descriptors then
+                local descriptor = descriptors[key]
+                if descriptor ~= nil then
+                    if descriptor.set then
+                        descriptor.set(self, value)
+                    else
+                        if descriptor.writable == false then
+                            error(
+                                ((("Cannot assign to read only property '" .. key) .. "' of object '") .. tostring(self)) .. "'",
+                                0
+                            )
+                        end
+                        descriptor.value = value
+                    end
+                    return
+                end
+            end
+            metatable = getmetatable(metatable)
+        end
+        rawset(self, key, value)
+    end
+end
+
+local __TS__SetDescriptor
+do
+    local getmetatable = _G.getmetatable
+    local function descriptorIndex(self, key)
+        return __TS__DescriptorGet(
+            self,
+            getmetatable(self),
+            key
+        )
+    end
+    local function descriptorNewIndex(self, key, value)
+        return __TS__DescriptorSet(
+            self,
+            getmetatable(self),
+            key,
+            value
+        )
+    end
+    function __TS__SetDescriptor(target, key, desc, isPrototype)
+        if isPrototype == nil then
+            isPrototype = false
+        end
+        local ____isPrototype_0
+        if isPrototype then
+            ____isPrototype_0 = target
+        else
+            ____isPrototype_0 = getmetatable(target)
+        end
+        local metatable = ____isPrototype_0
+        if not metatable then
+            metatable = {}
+            setmetatable(target, metatable)
+        end
+        if not isPrototype and not rawget(metatable, "_isOwnDescriptorMetatable") then
+            local instanceMetatable = {}
+            instanceMetatable._isOwnDescriptorMetatable = true
+            setmetatable(instanceMetatable, metatable)
+            setmetatable(target, instanceMetatable)
+            metatable = instanceMetatable
+        end
+        local value = rawget(target, key)
+        if value ~= nil then
+            rawset(target, key, nil)
+        end
+        if not rawget(metatable, "_descriptors") then
+            metatable._descriptors = {}
+        end
+        metatable._descriptors[key] = __TS__CloneDescriptor(desc)
+        metatable.__index = descriptorIndex
+        metatable.__newindex = descriptorNewIndex
+    end
+end
+-- End of Lua Library inline imports
+local ____exports = {}
+--- Native text entry hosted by a mounted Cell. Dispose it in that Cell's onMount cleanup.
+____exports.TextInput = __TS__Class()
+local TextInput = ____exports.TextInput
+TextInput.name = "TextInput"
+function TextInput.prototype.____constructor(self, parent, options)
+    if options == nil then
+        options = {}
+    end
+    self.disposed = false
+    self.Frame = CreateFrame("EditBox", nil, parent)
+    self.Frame:SetAutoFocus(false)
+    self.Frame:SetMultiLine(false)
+    self.Frame:SetFont("Fonts\\FRIZQT__.TTF", 12, "")
+    self.Frame:SetTextInsets(8, 8, 4, 4)
+    self.Frame:SetMaxBytes(options.maxBytes or 262144)
+    self.Frame:SetAllPoints(parent)
+    self.Frame:SetText(options.text or "")
+    self.Frame:SetScript(
+        "OnEscapePressed",
+        function()
+            self.Frame:ClearFocus()
+            local ____this_1
+            ____this_1 = options
+            local ____opt_0 = ____this_1.onEscape
+            if ____opt_0 ~= nil then
+                ____opt_0(____this_1)
+            end
+        end
+    )
+    self.Frame:Show()
+end
+function TextInput.prototype.Focus(self, selectAll)
+    if selectAll == nil then
+        selectAll = false
+    end
+    self.Frame:SetFocus()
+    if selectAll then
+        self.Frame:HighlightText()
+    end
+end
+function TextInput.prototype.Dispose(self)
+    if self.disposed then
+        return
+    end
+    self.disposed = true
+    self.Frame:ClearFocus()
+    self.Frame:SetScript("OnEscapePressed", nil)
+    self.Frame:Hide()
+end
+__TS__SetDescriptor(
+    TextInput.prototype,
+    "Value",
+    {get = function(self)
+        return self.Frame:GetText()
+    end},
+    true
+)
+return ____exports

package/lib/ui/Window.d.ts

@@ -9,6 +9,7 @@ export declare class Window {
     private content?;
     private pendingClose;
     private disposed;
+    private moving;
     constructor(options: WindowOptions);
     get IsOpen(): boolean;
     Open(view: Cell | (() => Cell | void)): void;
@@ -16,4 +17,5 @@ export declare class Window {
     BindDragHandle(handle: wuiraNativeFrame): () => void;
     Close(): void;
     Dispose(): void;
+    private StopMoving;
 }

package/lib/ui/Window.lua

@@ -159,6 +159,7 @@ Window.name = "Window"
 function Window.prototype.____constructor(self, options)
     self.pendingClose = false
     self.disposed = false
+    self.moving = false
     if not __TS__NumberIsFinite(options.width) or not __TS__NumberIsFinite(options.height) or options.width <= 0 or options.height <= 0 then
         error("Window requires positive finite dimensions")
     end
@@ -215,11 +216,12 @@ function Window.prototype.Open(self, view)
         error("Window: update protected content outside combat")
     end
     self.pendingClose = false
-    if self.content ~= nil then
-        wuira:Unmount(self.content)
+    local next = wuira:Mount(view, nil, self.Frame)
+    local previous = self.content
+    self.content = next
+    if previous ~= nil then
+        wuira:Unmount(previous)
     end
-    self.content = nil
-    self.content = wuira:Mount(view, nil, self.Frame)
     self.Frame:SetPropagateKeyboardInput(true)
     self.Frame:EnableKeyboard(true)
     self.Frame:Show()
@@ -232,15 +234,16 @@ function Window.prototype.BindDragHandle(self, handle)
         function()
             if not InCombatLockdown() then
                 self.Frame:StartMoving()
+                self.moving = true
             end
         end
     )
     handle:SetScript(
         "OnDragStop",
-        function() return self.Frame:StopMovingOrSizing() end
+        function() return self:StopMoving() end
     )
     return function()
-        self.Frame:StopMovingOrSizing()
+        self:StopMoving()
         handle:RegisterForDrag()
         handle:SetScript("OnDragStart", nil)
         handle:SetScript("OnDragStop", nil)
@@ -255,7 +258,7 @@ function Window.prototype.Close(self)
         return
     end
     self.pendingClose = false
-    self.Frame:StopMovingOrSizing()
+    self:StopMoving()
     self.Frame:EnableKeyboard(false)
     self.Frame:Hide()
     if self.content ~= nil then
@@ -279,6 +282,13 @@ function Window.prototype.Dispose(self)
     self.Frame:SetScript("OnKeyDown", nil)
     self.disposed = true
 end
+function Window.prototype.StopMoving(self)
+    if not self.moving then
+        return
+    end
+    self.Frame:StopMovingOrSizing()
+    self.moving = false
+end
 __TS__SetDescriptor(
     Window.prototype,
     "IsOpen",

package/lib/ui/index.d.ts

@@ -15,6 +15,8 @@ export type { CellProps } from "./Cell";
 export { FlowLayout } from "./FlowLayout";
 export { ForEach } from "./ForEach";
 export { Window } from "./Window";
+export { TextInput } from "./TextInput";
+export { ScrollHost } from "./ScrollHost";
 export type { WindowOptions } from "./Window";
 export type { ForEachProps } from "./ForEach";
 export { GridLayout } from "./GridLayout";

package/lib/ui/index.lua

@@ -40,6 +40,14 @@ do
     local ____Window = require("ui.Window")
     ____exports.Window = ____Window.Window
 end
+do
+    local ____TextInput = require("ui.TextInput")
+    ____exports.TextInput = ____TextInput.TextInput
+end
+do
+    local ____ScrollHost = require("ui.ScrollHost")
+    ____exports.ScrollHost = ____ScrollHost.ScrollHost
+end
 do
     local ____GridLayout = require("ui.GridLayout")
     ____exports.GridLayout = ____GridLayout.GridLayout

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wuira",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "author": {
     "name": "Kerim Cetinbas",
     "email": "a.cetinbas@icloud.com"