wuira 0.1.7 → 0.1.8

package/CHANGELOG.md

@@ -7,6 +7,37 @@ with the release date and highlight breaking changes explicitly.
 
 ## Unreleased
 
+## 0.1.8 — 2026-10-14
+
+### Added
+
+- Standalone `Window` hosts with draggable headers, Escape-to-close, content
+  cleanup, and protected-content close deferral.
+- Frameless `ForEach` JSX expansion with typed render children and nested groups.
+  Cell's single-child rule is enforced after expansion; lists are snapshots.
+- `Cell.condition` accepts a boolean or visibility callback, combines with existing
+  `visible`, and respects protected-tree combat deferral. Secret conditions hide cells.
+- `KnownSpells.Filter(pattern)` matches cached localized names with whole-name
+  `*`/`?` globs and ASCII case-insensitive comparisons, returning detached metadata.
+- Per-line `FlowLayout.justify` alignment (`start`, `center`, or `end`), including
+  wrapped rows and vertical columns.
+- Cached `KnownSpells.Entries` metadata and rank-aware `Find`, including localized
+  names and native passive flags. Metadata changes also notify observers.
+- Named Paladin Blessing, Greater Blessing, and Aura spell identifiers.
+
+### Fixed
+
+- Layout children accept mixed JSX siblings and nested arrays with ordered
+  expansion and cycle checks.
+
+### Validation and limitations
+
+- Lua and package tests cover loop expansion, typed render children, visibility,
+  cached name filtering, alignment, window cleanup, and protected close deferral.
+- ForEach expands a snapshot when its view is created. Applications own event
+  subscriptions and rebuild protected views outside combat. Serialized expression
+  parsing and the visual editor are application features.
+
 ## 0.1.7 — 2026-10-14
 
 ### Added

package/README.md

@@ -168,6 +168,21 @@ validate required arguments inside your callback.
 
 ### Addon settings and editing tools
 
+Create a standalone window with mounted JSX content. Bind a header as its drag
+handle; Escape or `Close()` releases the content while preserving the host's
+screen position for the next opening:
+
+```tsx
+import { Window, FlowLayout, Label } from "wuira/ui";
+
+const window = new Window({ width: 1000, height: 680 });
+window.Open(() => (
+    <FlowLayout onMount={frame => window.BindDragHandle(frame)}>
+        <Label height={40} text="My addon" />
+    </FlowLayout>
+));
+```
+
 Register a normal JSX view in Forever's native addon settings list:
 
 ```tsx
@@ -206,14 +221,65 @@ import { KnownSpells } from "wuira/datasources";
 const known = new KnownSpells();
 const spellIds = known.Value; // readonly number[], read from the cache
 const canJudge = known.Has(Spells.Judgement);
+const activeSpells = known.Entries.filter(spell => spell.isPassive === false);
+const learnedRank = known.Find(Spells.Judgement); // { id, name, isPassive } or undefined
+const seals = known.Filter("Seal*"); // Detached matching entries, including learned ranks.
 const stop = known.onChange(ids => console.log("Learned spells:", ids.length));
 // On disposal: stop(); known.Dispose();
 ```
 
+`Entries` returns detached cached metadata. An unknown passive flag stays
+`undefined`; unreadable spellbooks return no entries. Metadata changes also notify
+`onChange` observers, even when the spell IDs have not changed.
+
+`Filter` matches the entire localized name. `*` matches any sequence and `?` one
+byte; matching ignores ASCII case. Filtering reads the cache without polling the
+spellbook. Patterns must use names in the client's language.
+
 Protected button trees must be rebuilt outside combat; applications can defer a
 changed selection until `PLAYER_REGEN_ENABLED`. `Cell.alpha` changes appearance
 without changing a button's protected action or its interaction state.
 
+For wrapped action rows, `FlowLayout` supports `grow` and per-line `justify`:
+
+```tsx
+<FlowLayout width={220} height={52} direction="horizontal" gap={4} grow justify="center">
+    {buttons /* 24-unit buttons wrap after eight; the last row is centered. */}
+</FlowLayout>
+```
+
+Use `ForEach` to expand a snapshot into layout children without wrapper frames:
+
+```tsx
+import { UI } from "wuira";
+import { FlowLayout, ForEach, SecureButton } from "wuira/ui";
+
+function SealButtons() {
+    return (
+        <FlowLayout width={220} height={24} direction="horizontal" gap={4}>
+            <ForEach items={known.Filter("Seal*")}>
+                {(spell, index) => (
+                    <SecureButton width={24} height={24}
+                        action={{ type: "spell", spell: spell.id }} condition={spell.isPassive === false} />
+                )}
+            </ForEach>
+        </FlowLayout>
+    );
+}
+```
+
+The render function receives the item and its zero-based index. Use `ForEach`
+inside a layout for multiple siblings; Cell still accepts at most one expanded
+child. Nested loops are flattened in order. `ForEach` creates no subscriptions:
+recreate the view from `known.onChange` when needed, outside combat for protected
+trees. Each filtered rank remains a separate entry.
+
+All visual cells accept `condition={boolean}` or `condition={() => boolean}`.
+This controls visibility and retains the layout slot. It combines with datasource
+activity and the existing `visible` predicate. Callbacks use the shared visibility
+update driver; protected changes wait until combat ends. Secret conditions hide
+the cell without inspecting their value.
+
 ### Empty native action bars
 
 This is opt-in and removes real action-slot assignments, not just their visuals.

package/lib/Spells.d.ts

@@ -9,6 +9,26 @@ export declare enum Spells {
     LayOnHands = 633,
     BlessingOfProtection = 1022,
     BlessingOfFreedom = 1044,
+    BlessingOfMight = 19740,
+    BlessingOfWisdom = 19742,
+    BlessingOfKings = 20217,
+    BlessingOfLight = 19977,
+    BlessingOfSalvation = 1038,
+    BlessingOfSanctuary = 20911,
+    BlessingOfSacrifice = 6940,
+    GreaterBlessingOfMight = 25782,
+    GreaterBlessingOfWisdom = 25894,
+    GreaterBlessingOfKings = 25898,
+    GreaterBlessingOfLight = 25890,
+    GreaterBlessingOfSalvation = 25895,
+    GreaterBlessingOfSanctuary = 25899,
+    DevotionAura = 465,
+    RetributionAura = 7294,
+    ConcentrationAura = 19746,
+    ShadowResistanceAura = 19876,
+    FrostResistanceAura = 19888,
+    FireResistanceAura = 19891,
+    SanctityAura = 20218,
     VoiceOfTruth = 1310897,
     HammerOfJustice = 853,
     SealOfRighteousness = 21084,

package/lib/Spells.lua

@@ -20,6 +20,46 @@ ____exports.Spells.BlessingOfProtection = 1022
 ____exports.Spells[____exports.Spells.BlessingOfProtection] = "BlessingOfProtection"
 ____exports.Spells.BlessingOfFreedom = 1044
 ____exports.Spells[____exports.Spells.BlessingOfFreedom] = "BlessingOfFreedom"
+____exports.Spells.BlessingOfMight = 19740
+____exports.Spells[____exports.Spells.BlessingOfMight] = "BlessingOfMight"
+____exports.Spells.BlessingOfWisdom = 19742
+____exports.Spells[____exports.Spells.BlessingOfWisdom] = "BlessingOfWisdom"
+____exports.Spells.BlessingOfKings = 20217
+____exports.Spells[____exports.Spells.BlessingOfKings] = "BlessingOfKings"
+____exports.Spells.BlessingOfLight = 19977
+____exports.Spells[____exports.Spells.BlessingOfLight] = "BlessingOfLight"
+____exports.Spells.BlessingOfSalvation = 1038
+____exports.Spells[____exports.Spells.BlessingOfSalvation] = "BlessingOfSalvation"
+____exports.Spells.BlessingOfSanctuary = 20911
+____exports.Spells[____exports.Spells.BlessingOfSanctuary] = "BlessingOfSanctuary"
+____exports.Spells.BlessingOfSacrifice = 6940
+____exports.Spells[____exports.Spells.BlessingOfSacrifice] = "BlessingOfSacrifice"
+____exports.Spells.GreaterBlessingOfMight = 25782
+____exports.Spells[____exports.Spells.GreaterBlessingOfMight] = "GreaterBlessingOfMight"
+____exports.Spells.GreaterBlessingOfWisdom = 25894
+____exports.Spells[____exports.Spells.GreaterBlessingOfWisdom] = "GreaterBlessingOfWisdom"
+____exports.Spells.GreaterBlessingOfKings = 25898
+____exports.Spells[____exports.Spells.GreaterBlessingOfKings] = "GreaterBlessingOfKings"
+____exports.Spells.GreaterBlessingOfLight = 25890
+____exports.Spells[____exports.Spells.GreaterBlessingOfLight] = "GreaterBlessingOfLight"
+____exports.Spells.GreaterBlessingOfSalvation = 25895
+____exports.Spells[____exports.Spells.GreaterBlessingOfSalvation] = "GreaterBlessingOfSalvation"
+____exports.Spells.GreaterBlessingOfSanctuary = 25899
+____exports.Spells[____exports.Spells.GreaterBlessingOfSanctuary] = "GreaterBlessingOfSanctuary"
+____exports.Spells.DevotionAura = 465
+____exports.Spells[____exports.Spells.DevotionAura] = "DevotionAura"
+____exports.Spells.RetributionAura = 7294
+____exports.Spells[____exports.Spells.RetributionAura] = "RetributionAura"
+____exports.Spells.ConcentrationAura = 19746
+____exports.Spells[____exports.Spells.ConcentrationAura] = "ConcentrationAura"
+____exports.Spells.ShadowResistanceAura = 19876
+____exports.Spells[____exports.Spells.ShadowResistanceAura] = "ShadowResistanceAura"
+____exports.Spells.FrostResistanceAura = 19888
+____exports.Spells[____exports.Spells.FrostResistanceAura] = "FrostResistanceAura"
+____exports.Spells.FireResistanceAura = 19891
+____exports.Spells[____exports.Spells.FireResistanceAura] = "FireResistanceAura"
+____exports.Spells.SanctityAura = 20218
+____exports.Spells[____exports.Spells.SanctityAura] = "SanctityAura"
 ____exports.Spells.VoiceOfTruth = 1310897
 ____exports.Spells[____exports.Spells.VoiceOfTruth] = "VoiceOfTruth"
 ____exports.Spells.HammerOfJustice = 853

package/lib/datasources/KnownSpells.d.ts

@@ -1,19 +1,31 @@
 import { DataSource } from "./DataSource";
 export type KnownSpellsStatus = "ready" | "unavailable" | "restricted";
+export interface KnownSpell {
+    readonly id: number;
+    readonly name?: string;
+    /** Undefined when the client cannot determine whether this spell is passive. */
+    readonly isPassive?: boolean;
+}
 /** Cached learned player spellbook IDs. Native events refresh the snapshot; no polling. */
 export declare class KnownSpells extends DataSource<readonly number[]> {
     private ids;
-    private names;
+    private entries;
     private status;
     private readonly listeners;
     private readonly frame;
     private disposed;
     constructor();
     get Status(): KnownSpellsStatus;
+    /** Detached cached metadata, with no native reads. Unreadable books return no entries. */
+    get Entries(): readonly KnownSpell[];
+    /** Whole-name glob over cached localized names. Supports * and ?, ignoring ASCII case. */
+    Filter(pattern: string): readonly KnownSpell[];
     protected GetValue(): readonly number[];
     protected HasSecretFields(): boolean;
     /** Representative enum IDs match any learned rank through its localized name. */
     Has(spell: number | string): boolean;
+    /** Resolve a representative spell ID or localized name to a learned rank. */
+    Find(spell: number | string): KnownSpell | undefined;
     /** No initial emission; only changed, readable snapshots reach observers. */
     onChange(listener: (spells: readonly number[]) => void): () => void;
     private Refresh;