wuira 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -7,6 +7,22 @@ with the release date and highlight breaking changes explicitly.
 
 ## Unreleased
 
+## 0.3.2 — 2026-10-19
+
+### Fixed
+
+- Older `justify` uses only leftover space. A line wider than its container stays at the start instead of being pulled backward.
+
+## 0.3.1 — 2026-10-19
+
+### Added
+
+- `width` and `height` accept `"fill"`. Fill children share the space left after fixed siblings. `"inherit"` still takes the whole parent.
+- Flow and grid accept `ltr`, `rtl`, `ttb`, and `btt`, plus `alignX` and `alignY`. A child's anchor places it inside its slot. Older `horizontal`, `vertical`, and `justify` values still apply.
+- Flow `columnGap` and `rowGap` set horizontal and vertical spacing independently. Older `gap` and `lineGap` still apply when the matching axis is unset.
+- `startOverlayGlow` draws Pixel, button overlay, autocast shine, and proc styles with additive textures. It returns a stop function and does not depend on another addon.
+- Static client catalogs for progress textures, backgrounds, borders, and fonts. A catalog key resolves to a Blizzard path; any other string remains a custom path.
+
 ## 0.3.0 — 2026-10-17
 
 ### Breaking

package/lib/platform/forever.d.ts

@@ -7,6 +7,7 @@ interface wuiraNativeTexture {
     SetAllPoints(frame: wuiraNativeFrame): void;
     SetColorTexture(red: number, green: number, blue: number, alpha: number): void;
     SetTexture(path: string | number | undefined): void;
+    SetAtlas(atlas: string): void;
     SetVertexColor(red: number, green: number, blue: number, alpha: number): void;
     SetBlendMode(mode: import("../types/Texture").BlendMode): void;
     SetHorizTile(enabled: boolean): void;
@@ -101,7 +102,7 @@ interface wuiraNativeStatusBar extends wuiraNativeFrame {
     GetStatusBarTexture(): wuiraNativeTexture;
     SetMinMaxValues(min: number, max: number): void;
     SetValue(value: number): void;
-    SetStatusBarTexture(path: string): void;
+    SetStatusBarTexture(path: string | number): void;
     SetStatusBarColor(red: number, green: number, blue: number, alpha: number): void;
     SetOrientation(orientation: "HORIZONTAL" | "VERTICAL"): void;
     SetReverseFill(reverse: boolean): void;

package/lib/rendering/layout.lua

@@ -463,8 +463,8 @@ function ____exports.prepareLayout(self, element, parent, mountedFrames)
         nil,
         element,
         {
-            width = rootProps.width == "inherit" and parent:GetWidth() or nil,
-            height = rootProps.height == "inherit" and parent:GetHeight() or nil
+            width = (rootProps.width == "inherit" or rootProps.width == "fill") and parent:GetWidth() or nil,
+            height = (rootProps.height == "inherit" or rootProps.height == "fill") and parent:GetHeight() or nil
         }
     )
     local ____temp_3 = parent ~= UIParent

package/lib/rendering/progress.lua

@@ -54,16 +54,18 @@ local ____exports = {}
 local ____Resources = require("datasources.Resources")
 local HP = ____Resources.HP
 local ____statusBarTextures = require("ui.decorations.statusBarTextures")
+local applyStatusBarTexture = ____statusBarTextures.applyStatusBarTexture
 local resolveStatusBarTexture = ____statusBarTextures.resolveStatusBarTexture
 function ____exports.renderProgress(self, item, tree, onActiveChange)
     local props = item.cell.props
     local bar = item.frame
     local ____opt_0 = props.foreground
     local color = ____opt_0 and ____opt_0.color or props.color
-    local ____bar_SetStatusBarTexture_5 = bar.SetStatusBarTexture
+    local ____applyStatusBarTexture_5 = applyStatusBarTexture
     local ____resolveStatusBarTexture_4 = resolveStatusBarTexture
     local ____opt_2 = props.foreground
-    ____bar_SetStatusBarTexture_5(
+    ____applyStatusBarTexture_5(
+        nil,
         bar,
         ____resolveStatusBarTexture_4(nil, ____opt_2 and ____opt_2.texture or props.texture or "solid")
     )
@@ -107,7 +109,11 @@ function ____exports.renderProgress(self, item, tree, onActiveChange)
                 layer:EnableMouse(false)
                 layer:SetFrameLevel(bar:GetFrameLevel())
                 layer:SetSize(item.width, item.height)
-                layer:SetStatusBarTexture(resolveStatusBarTexture(nil, style.texture or "solid"))
+                applyStatusBarTexture(
+                    nil,
+                    layer,
+                    resolveStatusBarTexture(nil, style.texture or "solid")
+                )
                 local tint = style.color
                 layer:SetStatusBarColor(tint.r, tint.g, tint.b, tint.a or 0.5)
                 local texture = layer:GetStatusBarTexture()

package/lib/rendering/widgets.lua

@@ -6,6 +6,9 @@ local ____secureButton = require("rendering.secureButton")
 local renderSecureButton = ____secureButton.renderSecureButton
 local ____progress = require("rendering.progress")
 local renderProgress = ____progress.renderProgress
+local ____clientMedia = require("ui.media.clientMedia")
+local resolveMediaPath = ____clientMedia.resolveMediaPath
+local clientFonts = ____clientMedia.clientFonts
 function ____exports.createWidget(self, cell, parent)
     local frame = cell.kind == "progress" and CreateFrame("StatusBar", nil, parent) or (cell.kind == "secureButton" and createSecureButton(nil, parent, cell.props) or (cell.kind == "button" and CreateFrame("Button", nil, parent) or CreateFrame("Frame", nil, parent)))
     frame:Hide()
@@ -43,7 +46,11 @@ function ____exports.renderWidget(self, item, tree, updates, onActiveChange)
         local props = item.cell.props
         local label = item.frame:CreateFontString(nil, "OVERLAY")
         label:SetAllPoints(item.frame)
-        label:SetFont(props.font or "Fonts\\FRIZQT__.TTF", props.fontSize or 12, "OUTLINE")
+        label:SetFont(
+            resolveMediaPath(nil, clientFonts, props.font or "friz"),
+            props.fontSize or 12,
+            "OUTLINE"
+        )
         label:SetJustifyH(props.align or "LEFT")
         label:SetJustifyV("MIDDLE")
         local color = props.color

package/lib/ui/Cell.d.ts

@@ -2,7 +2,7 @@ import type { Element } from "./primitives/jsx";
 import type { Decorations } from "./decorations/Decorations";
 import type { Position } from "../types/Position";
 import type { Spacing } from "../types/Spacing";
-export type Size = number | "inherit";
+export type Size = number | "inherit" | "fill";
 /** Common visual descriptor accepted by the mounting API. */
 export interface Cell extends Element {
 }

package/lib/ui/FlowLayout.d.ts

@@ -1,12 +1,24 @@
 import type { LayoutProps, ILayout } from "./Layout";
 import type { Element, Children } from "./primitives/jsx";
+export type FlowDirection = "ltr" | "rtl" | "ttb" | "btt" | "horizontal" | "vertical" | "horizontalReverse" | "verticalReverse";
 export interface FlowOptions {
-    direction: "horizontal" | "vertical";
-    /** Wrap to another row (horizontal) or column (vertical) when full. */
+    /** ltr packs left to right. rtl packs right to left. ttb packs top to bottom. btt packs bottom to top. horizontal and vertical remain readable. */
+    direction: FlowDirection;
+    /** Wrap to another row or column when full. */
     grow?: boolean;
-    /** Space between rows/columns; defaults to gap. */
+    /** Horizontal space between children. Falls back to gap or lineGap, depending on direction. */
+    columnGap?: number;
+    /** Vertical space between children. Falls back to gap or lineGap, depending on direction. */
+    rowGap?: number;
+    /** Older shared spacing, used when columnGap or rowGap is unset. */
+    gap?: number;
+    /** Older cross-axis spacing, used when the matching axis gap is unset. */
     lineGap?: number;
-    /** Align each row/column along the flow direction. Defaults to start. */
+    /** Places the arranged lines on the horizontal axis. */
+    alignX?: "left" | "center" | "right";
+    /** Places the arranged lines on the vertical axis. */
+    alignY?: "top" | "center" | "bottom";
+    /** Older main-axis alignment, used when the matching axis position is unset. */
     justify?: "start" | "center" | "end";
 }
 export type FlowLayoutProps = LayoutProps & FlowOptions;

package/lib/ui/GridLayout.d.ts

@@ -1,9 +1,18 @@
 import type { LayoutProps, ILayout } from "./Layout";
+import type { FlowDirection } from "./FlowLayout";
 import type { Element, Children } from "./primitives/jsx";
 export interface GridOptions {
     columns: number;
-    rowGap?: number;
+    /** ltr fills rows left to right. ttb fills columns top to bottom. Older horizontal and vertical values remain readable. */
+    direction?: FlowDirection;
+    /** Places the whole grid on the horizontal axis. */
+    alignX?: "left" | "center" | "right";
+    /** Places the whole grid on the vertical axis. */
+    alignY?: "top" | "center" | "bottom";
+    /** Horizontal space between columns. Falls back to gap. */
     columnGap?: number;
+    /** Vertical space between rows. Falls back to gap. */
+    rowGap?: number;
     /** Defaults to the maximum child width/height. Does not resize children. */
     cellWidth?: number;
     cellHeight?: number;

package/lib/ui/ScrollHost.lua

@@ -21,7 +21,12 @@ function ScrollHost.prototype.____constructor(self, parent, onScroll)
         parent:GetHeight()
     )
     self.Frame:SetAllPoints(parent)
-    self.Frame:EnableMouse(true)
+    self.Frame:EnableMouse(false)
+    local wheel = self.Frame
+    local ____opt_0 = wheel.EnableMouseWheel
+    if ____opt_0 ~= nil then
+        ____opt_0(wheel, true)
+    end
     self.Frame:SetScript(
         "OnMouseWheel",
         function(_frame, delta) return self:ScrollBy(-delta * 32) end
@@ -51,9 +56,9 @@ function ScrollHost.prototype.ScrollTo(self, offset)
         )
     )
     self.Frame:SetVerticalScroll(value)
-    local ____opt_0 = self.onScroll
-    if ____opt_0 ~= nil then
-        ____opt_0(self, value)
+    local ____opt_2 = self.onScroll
+    if ____opt_2 ~= nil then
+        ____opt_2(self, value)
     end
 end
 function ScrollHost.prototype.Dispose(self)

package/lib/ui/decorations/backgroundTextures.d.ts

@@ -1,25 +1,5 @@
-export declare const backgroundTextures: {
-    readonly solid: {
-        readonly label: "Solid";
-        readonly path: "Interface\\Buttons\\WHITE8X8";
-    };
-    readonly tooltip: {
-        readonly label: "Blizzard Tooltip";
-        readonly path: "Interface\\Tooltips\\UI-Tooltip-Background";
-    };
-    readonly dialog: {
-        readonly label: "Blizzard Dialog";
-        readonly path: "Interface\\DialogFrame\\UI-DialogBox-Background";
-    };
-    readonly dialogDark: {
-        readonly label: "Blizzard Dialog Dark";
-        readonly path: "Interface\\DialogFrame\\UI-DialogBox-Background-Dark";
-    };
-    readonly dialogGold: {
-        readonly label: "Blizzard Dialog Gold";
-        readonly path: "Interface\\DialogFrame\\UI-DialogBox-Gold-Background";
-    };
-};
+import { backgroundTextures } from "../media/clientMedia";
+export { backgroundTextures };
 export type BackgroundTexture = keyof typeof backgroundTextures | {
     path: string;
 };

package/lib/ui/decorations/backgroundTextures.lua

@@ -1,10 +1,6 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
-____exports.backgroundTextures = {
-    solid = {label = "Solid", path = "Interface\\Buttons\\WHITE8X8"},
-    tooltip = {label = "Blizzard Tooltip", path = "Interface\\Tooltips\\UI-Tooltip-Background"},
-    dialog = {label = "Blizzard Dialog", path = "Interface\\DialogFrame\\UI-DialogBox-Background"},
-    dialogDark = {label = "Blizzard Dialog Dark", path = "Interface\\DialogFrame\\UI-DialogBox-Background-Dark"},
-    dialogGold = {label = "Blizzard Dialog Gold", path = "Interface\\DialogFrame\\UI-DialogBox-Gold-Background"}
-}
+local ____clientMedia = require("ui.media.clientMedia")
+local backgroundTextures = ____clientMedia.backgroundTextures
+____exports.backgroundTextures = backgroundTextures
 return ____exports

package/lib/ui/decorations/borderTextures.d.ts

@@ -1,40 +1,5 @@
-export declare const borderTextures: {
-    readonly solid: {
-        readonly label: "Solid";
-        readonly path: "";
-        readonly edgeSize: 1;
-    };
-    readonly tooltip: {
-        readonly label: "Blizzard Tooltip";
-        readonly path: "Interface\\Tooltips\\UI-Tooltip-Border";
-        readonly edgeSize: 16;
-    };
-    readonly dialog: {
-        readonly label: "Blizzard Dialog";
-        readonly path: "Interface\\DialogFrame\\UI-DialogBox-Border";
-        readonly edgeSize: 32;
-    };
-    readonly dialogGold: {
-        readonly label: "Blizzard Dialog Gold";
-        readonly path: "Interface\\DialogFrame\\UI-DialogBox-Gold-Border";
-        readonly edgeSize: 32;
-    };
-    readonly achievementWood: {
-        readonly label: "Blizzard Achievement Wood";
-        readonly path: "Interface\\AchievementFrame\\UI-Achievement-WoodBorder";
-        readonly edgeSize: 16;
-    };
-    readonly chatBubble: {
-        readonly label: "Blizzard Chat Bubble";
-        readonly path: "Interface\\Tooltips\\ChatBubble-Backdrop";
-        readonly edgeSize: 16;
-    };
-    readonly party: {
-        readonly label: "Blizzard Party";
-        readonly path: "Interface\\CHARACTERFRAME\\UI-Party-Border";
-        readonly edgeSize: 16;
-    };
-};
+import { borderTextures } from "../media/clientMedia";
+export { borderTextures };
 export type BorderTexture = keyof typeof borderTextures | {
     path: string;
     edgeSize: number;

package/lib/ui/decorations/borderTextures.lua

@@ -1,12 +1,6 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
-____exports.borderTextures = {
-    solid = {label = "Solid", path = "", edgeSize = 1},
-    tooltip = {label = "Blizzard Tooltip", path = "Interface\\Tooltips\\UI-Tooltip-Border", edgeSize = 16},
-    dialog = {label = "Blizzard Dialog", path = "Interface\\DialogFrame\\UI-DialogBox-Border", edgeSize = 32},
-    dialogGold = {label = "Blizzard Dialog Gold", path = "Interface\\DialogFrame\\UI-DialogBox-Gold-Border", edgeSize = 32},
-    achievementWood = {label = "Blizzard Achievement Wood", path = "Interface\\AchievementFrame\\UI-Achievement-WoodBorder", edgeSize = 16},
-    chatBubble = {label = "Blizzard Chat Bubble", path = "Interface\\Tooltips\\ChatBubble-Backdrop", edgeSize = 16},
-    party = {label = "Blizzard Party", path = "Interface\\CHARACTERFRAME\\UI-Party-Border", edgeSize = 16}
-}
+local ____clientMedia = require("ui.media.clientMedia")
+local borderTextures = ____clientMedia.borderTextures
+____exports.borderTextures = borderTextures
 return ____exports

package/lib/ui/decorations/statusBarTextures.d.ts

@@ -1,12 +1,5 @@
-export declare const statusBarTextures: {
-    readonly solid: {
-        readonly label: "Solid";
-        readonly path: "Interface\\Buttons\\WHITE8X8";
-    };
-    readonly blizzard: {
-        readonly label: "Blizzard Status Bar";
-        readonly path: "Interface\\TargetingFrame\\UI-StatusBar";
-    };
-};
-/** Accepts catalog names or a native/custom texture path. */
-export declare function resolveStatusBarTexture(texture: string): string;
+export { progressTextures as statusBarTextures } from "../media/clientMedia";
+/** Accepts a catalog name, a texture path, a status-bar atlas, or a numeric client file id. */
+export declare function resolveStatusBarTexture(texture: string): string | number;
+/** Power-bar entries from the client are atlases. A file path stays on SetStatusBarTexture. */
+export declare function applyStatusBarTexture(bar: wuiraNativeStatusBar, texture: string | number): void;

package/lib/ui/decorations/statusBarTextures.lua

@@ -1,9 +1,88 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+-- Lua Library inline imports
+local function __TS__StringCharCodeAt(self, index)
+    if index ~= index then
+        index = 0
+    end
+    if index < 0 then
+        return 0 / 0
+    end
+    return string.byte(self, index + 1) or 0 / 0
+end
+
+local function __TS__Number(value)
+    local valueType = type(value)
+    if valueType == "number" then
+        return value
+    elseif valueType == "string" then
+        local numberValue = tonumber(value)
+        if numberValue then
+            return numberValue
+        end
+        if value == "Infinity" then
+            return math.huge
+        end
+        if value == "-Infinity" then
+            return -math.huge
+        end
+        local stringWithoutSpaces = string.gsub(value, "%s", "")
+        if stringWithoutSpaces == "" then
+            return 0
+        end
+        return 0 / 0
+    elseif valueType == "boolean" then
+        return value and 1 or 0
+    else
+        return 0 / 0
+    end
+end
+-- End of Lua Library inline imports
 local ____exports = {}
-____exports.statusBarTextures = {solid = {label = "Solid", path = "Interface\\Buttons\\WHITE8X8"}, blizzard = {label = "Blizzard Status Bar", path = "Interface\\TargetingFrame\\UI-StatusBar"}}
---- Accepts catalog names or a native/custom texture path.
+local ____clientMedia = require("ui.media.clientMedia")
+local progressTextures = ____clientMedia.progressTextures
+do
+    local ____clientMedia = require("ui.media.clientMedia")
+    ____exports.statusBarTextures = ____clientMedia.progressTextures
+end
+local function fileId(self, value)
+    if #value == 0 then
+        return nil
+    end
+    local index = 0
+    while index < #value do
+        local code = __TS__StringCharCodeAt(value, index)
+        if code < 48 or code > 57 then
+            return nil
+        end
+        index = index + 1
+    end
+    return __TS__Number(value)
+end
+--- Accepts a catalog name, a texture path, a status-bar atlas, or a numeric client file id.
 function ____exports.resolveStatusBarTexture(self, texture)
-    local preset = ____exports.statusBarTextures[texture]
-    return preset == nil and texture or preset.path
+    local preset = progressTextures[texture]
+    if preset ~= nil then
+        return preset.path
+    end
+    return fileId(nil, texture) or texture
+end
+local function isAtlas(self, name)
+    if type(GetAtlasInfo) == "function" and GetAtlasInfo(name) ~= nil then
+        return true
+    end
+    local textures = C_Texture
+    return textures ~= nil and textures.GetAtlasInfo ~= nil and textures.GetAtlasInfo(name) ~= nil
+end
+--- Power-bar entries from the client are atlases. A file path stays on SetStatusBarTexture.
+function ____exports.applyStatusBarTexture(self, bar, texture)
+    if type(texture) == "string" and isAtlas(nil, texture) then
+        bar:SetStatusBarTexture("Interface\\Buttons\\WHITE8X8")
+        local fill = bar:GetStatusBarTexture()
+        if fill ~= nil and fill.SetAtlas ~= nil then
+            fill:SetAtlas(texture)
+        end
+        return
+    end
+    bar:SetStatusBarTexture(texture)
 end
 return ____exports

package/lib/ui/index.d.ts

@@ -24,8 +24,13 @@ export { ProgressBar } from "./ProgressBar";
 export { Background } from "./decorations/Background";
 export { Border } from "./decorations/Border";
 export { Glow } from "./decorations/Glow";
+export { startOverlayGlow } from "./overlayGlow";
+export type { OverlayGlowKind, OverlayGlowOptions } from "./overlayGlow";
 export { Tooltip } from "./decorations/Tooltip";
 export type { TooltipProps, TooltipAnchor, TooltipLine, NativeTooltip } from "./decorations/Tooltip";
+export { progressTextures, backgroundTextures, borderTextures, clientFonts } from "./media/clientMedia";
+export type { ClientMedia, ClientBorder } from "./media/clientMedia";
+export { resolveMediaPath } from "./media/clientMedia";
 export { Label } from "./Label";
 export type { LabelProps } from "./Label";
 export { Icon } from "./Icon";

package/lib/ui/index.lua

@@ -68,10 +68,25 @@ do
     local ____Glow = require("ui.decorations.Glow")
     ____exports.Glow = ____Glow.Glow
 end
+do
+    local ____overlayGlow = require("ui.overlayGlow")
+    ____exports.startOverlayGlow = ____overlayGlow.startOverlayGlow
+end
 do
     local ____Tooltip = require("ui.decorations.Tooltip")
     ____exports.Tooltip = ____Tooltip.Tooltip
 end
+do
+    local ____clientMedia = require("ui.media.clientMedia")
+    ____exports.progressTextures = ____clientMedia.progressTextures
+    ____exports.backgroundTextures = ____clientMedia.backgroundTextures
+    ____exports.borderTextures = ____clientMedia.borderTextures
+    ____exports.clientFonts = ____clientMedia.clientFonts
+end
+do
+    local ____clientMedia = require("ui.media.clientMedia")
+    ____exports.resolveMediaPath = ____clientMedia.resolveMediaPath
+end
 do
     local ____Label = require("ui.Label")
     ____exports.Label = ____Label.Label

package/lib/ui/layout/calculateFlow.d.ts

@@ -1,12 +1,24 @@
 import type { FlowLayoutProps } from "../FlowLayout";
-/** Pure layout calculation in top-left UI coordinates. */
-export declare function calculateFlow(props: FlowLayoutProps & {
+export interface FlowChild {
     width: number;
     height: number;
-}, children: readonly {
+    anchor?: string;
+}
+/** Horizontal space is columnGap. Vertical space is rowGap. Older gap and lineGap fill whichever axis is unset. */
+export declare function flowSpacing(direction: string | undefined, props: {
+    gap?: number;
+    lineGap?: number;
+    columnGap?: number;
+    rowGap?: number;
+}): {
+    main: number;
+    cross: number;
+};
+/** Pack children along one direction, then place the group and each child separately. */
+export declare function calculateFlow(props: FlowLayoutProps & {
     width: number;
     height: number;
-}[]): {
+}, children: readonly FlowChild[]): {
     x: number;
     y: number;
 }[];