wuira 0.1.1 → 0.1.2

package/README.md

@@ -195,6 +195,8 @@ An empty fragment creates no native frame. Only empty fragments are currently su
 
 `console.log/info/warn/error` use a global WoW console polyfill. Output goes to the local chat window, never to other players. The addon uses no Node.js runtime or stdin/stdout. `console.error` does not throw. Arguments are formatted with Lua `tostring`; objects are not deeply inspected. The CLI uses its own Node.js terminal console.
 
+Importing `wuira` installs the global console polyfill automatically. The shared TypeScript config loads its global declarations and uses Node16 module resolution for package exports; DOM typings are not required. `wuira.Mount` accepts a `Cell`, no value, or a function returning `Cell | void`, so addons without a visual tree can simply log and return.
+
 ## Build and distribution
 
 `wuira build` transpiles through `tsconfig.json`. It writes a standalone addon directory containing individual Lua modules, a loader, a startup file, and `<addonName>.toc`. The default output directory is `dist/`. The addon name lives in `wuira.config.mjs`; Interface version and other metadata live in `addon.toc.in`. The default Interface version, 16001, targets the Forever playground.

package/config/tsconfig.json

@@ -2,10 +2,12 @@
   "$schema": "https://raw.githubusercontent.com/TypeScriptToLua/TypeScriptToLua/master/tsconfig-schema.json",
   "compilerOptions": {
     "target": "ESNext",
+    "module": "Node16",
+    "moduleResolution": "Node16",
     "lib": [
       "ESNext"
     ],
-    "types": [],
+    "types": ["wuira/console-polyfill"],
     "jsx": "react",
     "jsxFactory": "UI.createElement",
     "jsxFragmentFactory": "UI.Fragment",

package/lib/index.d.ts

@@ -1,4 +1,6 @@
 /// <reference path="./platform/forever.d.ts" />
+import "./console-polyfill";
 export { wuira } from "./wuira";
 export { UI } from "./ui/primitives/jsx";
 export type { Element, Component } from "./ui/primitives/jsx";
+export type { Cell } from "./ui/Cell";

package/lib/index.lua

@@ -1,5 +1,6 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
+require("console-polyfill")
 do
     local ____wuira = require("wuira")
     ____exports.wuira = ____wuira.wuira

package/lib/ui/Cell.d.ts

@@ -3,6 +3,9 @@ import type { Decorations } from "./decorations/Decorations";
 import type { Position } from "../types/Position";
 import type { Spacing } from "../types/Spacing";
 export type Size = number | "inherit";
+/** Common visual descriptor accepted by the mounting API. */
+export interface Cell extends Element {
+}
 export type CellProps = {
     width: Size;
     height: Size;
@@ -18,4 +21,4 @@ export interface ICell extends Element {
 }
 export declare function Cell(props: Partial<CellProps> & {
     child?: Element;
-}, child?: Element): Element;
+}, child?: Element): Cell;

package/lib/ui/Cell.lua

@@ -2,6 +2,7 @@
 local ____exports = {}
 local ____jsx = require("ui.primitives.jsx")
 local UI = ____jsx.UI
+--- Common visual descriptor accepted by the mounting API.
 function ____exports.Cell(self, props, child)
     return UI:createElement("cell", props, props.child or child or ({}))
 end

package/lib/wuira.d.ts

@@ -1,8 +1,8 @@
-import type { Element } from "./ui/primitives/jsx";
+import type { Cell } from "./ui/Cell";
 import type { Anchor } from "./types/Position";
 /** Public entry point for mounting JSX UI trees. */
 export declare class wuira {
     private constructor();
-    static Mount(frame: Element | (() => Element), anchor?: Anchor, parent?: wuiraNativeFrame): wuiraNativeFrame | undefined;
+    static Mount(frame: Cell | void | (() => Cell | void), anchor?: Anchor, parent?: wuiraNativeFrame): wuiraNativeFrame | undefined;
     static Unmount(frame: wuiraNativeFrame): void;
 }

package/lib/wuira.lua

@@ -18,8 +18,14 @@ wuira.name = "wuira"
 function wuira.prototype.____constructor(self)
 end
 function wuira.Mount(self, frame, anchor, parent)
-    local view = type(frame) == "function" and frame(nil) or frame
-    if view.kind == "empty" then
+    local ____temp_0
+    if type(frame) == "function" then
+        ____temp_0 = frame(nil)
+    else
+        ____temp_0 = frame
+    end
+    local view = ____temp_0
+    if view == nil or view.kind == "empty" then
         return nil
     end
     return mount(nil, view, parent, anchor)

package/package.json

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

package/templates/addon/src/index.tsx

@@ -1,9 +1,7 @@
-import "wuira/console-polyfill";
-import { UI, wuira } from "wuira";
+import { wuira } from "wuira";
 
 function App() {
     console.log("{{addonName}} loaded");
-    return <></>;
 }
 
 wuira.Mount(App);