@simpludify/core 0.1.2 → 0.1.3

package/README.md

@@ -1,11 +1,11 @@
 # @simpludify/core
 
-Experimental v0.1.2 of Simpludify, a code-first TypeScript 2D engine. APIs may change between 0.x releases. This package contains host-independent Scene/Actor/Component, collision, geometry, tilemaps, tween/animation, input and Canvas UI models. It has no browser or Node runtime dependencies.
+Experimental v0.1.3 of Simpludify, a code-first TypeScript 2D engine. APIs may change between 0.x releases. This package contains host-independent Scene/Actor/Component, collision, geometry, tilemaps, tween/animation, input and Canvas UI models. It has no browser or Node runtime dependencies.
 
-Registry installation (check availability with `npm view @simpludify/core@0.1.2 version`):
+Registry installation (check availability with `npm view @simpludify/core@0.1.3 version`):
 
 ```sh
-npm install @simpludify/core@0.1.2
+npm install @simpludify/core@0.1.3
 ```
 
 ```js

package/dist/foundation/version.d.ts

@@ -1,2 +1,2 @@
 /** Source workspace version; checked against package.json by the build validator. */
-export declare const ENGINE_VERSION = "0.1.2";
+export declare const ENGINE_VERSION = "0.1.3";

package/dist/index.js

@@ -1583,7 +1583,7 @@ var RandomManager = class {
 };
 // packages/core/src/foundation/version.ts
 /** Source workspace version; checked against package.json by the build validator. */
-var ENGINE_VERSION = "0.1.2";
+var ENGINE_VERSION = "0.1.3";
 // packages/core/src/scene/actor.ts
 var inputPhase$1 = ComponentPhase.Input;
 var updatePhase$1 = ComponentPhase.Update;
@@ -6269,7 +6269,7 @@ var ReplayPlayer = class {
 		this.engine = engine;
 		this.data = parseReplayData(data);
 		this.bound = bindings(engine, options.controllers);
-		if (this.data.engineVersion !== "0.1.2" || engine.random.seed !== this.data.random.seed) throw new EngineError("REPLAY_INCOMPATIBLE", "Engine version or initial seed does not match Replay");
+		if (this.data.engineVersion !== "0.1.3" || engine.random.seed !== this.data.random.seed) throw new EngineError("REPLAY_INCOMPATIBLE", "Engine version or initial seed does not match Replay");
 		if (!compatible(this.bound.map(([id, c]) => ({
 			id,
 			actions: c.schema()
@@ -6639,11 +6639,22 @@ var CanvasNode = class {
 	}
 	click;
 	hold;
+	/** @internal Text semantics supplied by CanvasLabel. */
+	labelSemantics;
 	/** @internal Prefer CanvasPanel/Label/Button/HoldButton. */
 	constructor(kind, options = {}) {
 		this.kind = kind;
 		this.captionValue = options.text ?? "";
 		if (typeof this.captionValue !== "string") throw new EngineError("INVALID_UI", "UI text must be a string");
+		if (options.label) {
+			const { role, level } = options.label;
+			if (kind !== "label" || role !== void 0 && ![
+				"heading",
+				"status",
+				"alert"
+			].includes(role) || (role === "heading" ? typeof level !== "number" || !Number.isInteger(level) || level < 1 || level > 6 : level !== void 0)) throw new EngineError("INVALID_UI", "Invalid label semantics");
+			this.labelSemantics = Object.freeze({ ...options.label });
+		}
 		this.config = checkedStyle(options.style ?? {});
 		this.click = options.click;
 		this.hold = options.hold;
@@ -6889,9 +6900,17 @@ function CanvasColumn(children, style = {}) {
 		direction: "column"
 	});
 }
-function CanvasLabel(text, style = {}) {
+function CanvasLabel(content, style = {}) {
+	if (typeof content === "string") return new CanvasNode("label", {
+		text: content,
+		style
+	});
+	if (!content || typeof content !== "object") throw new EngineError("INVALID_UI", "UI label must be text or options");
+	const { text, ...label } = content;
+	if (typeof text !== "string") throw new EngineError("INVALID_UI", "UI text must be a string");
 	return new CanvasNode("label", {
 		text,
+		label,
 		style
 	});
 }
@@ -7361,6 +7380,9 @@ var CanvasTextEditorNode = class extends CanvasInputNode {
 		this.buffer = snapshot(initialText);
 		this.onDispose(() => this.session?.cancel());
 	}
+	get inputMode() {
+		return this.kind === "number-input" ? "decimal" : "text";
+	}
 	get limit() {}
 	get draft() {
 		return this.buffer;
@@ -7386,7 +7408,7 @@ var CanvasTextEditorNode = class extends CanvasInputNode {
 			text: this.editing ? this.buffer.text : this.format(this.value),
 			placeholder: this.hint,
 			maxLength: this.limit,
-			inputMode: this.kind === "number-input" ? "decimal" : "text",
+			inputMode: this.inputMode,
 			readOnly: this.readOnly
 		});
 	}
@@ -7669,7 +7691,16 @@ function validText(value, limit) {
 var CanvasTextInputNode = class extends CanvasTextEditorNode {
 	constraints;
 	constructor(options = {}, style = {}) {
-		const constraints = { maxLength: lengthLimit(options.maxLength) }, initial = validText(options.value ?? "", constraints.maxLength);
+		const inputMode = options.inputMode ?? "text";
+		if (![
+			"text",
+			"numeric",
+			"decimal"
+		].includes(inputMode)) throw new EngineError("INVALID_UI", "Invalid text keyboard hint");
+		const constraints = {
+			maxLength: lengthLimit(options.maxLength),
+			inputMode
+		}, initial = validText(options.value ?? "", constraints.maxLength);
 		super("text-input", options.label ?? "Text", initial, (value) => validText(value, constraints.maxLength), options.readOnly ?? false, options.placeholder ?? "", initial, style);
 		this.constraints = constraints;
 	}
@@ -7680,6 +7711,9 @@ var CanvasTextInputNode = class extends CanvasTextEditorNode {
 		if (this.maxLength !== void 0 && text.length > this.maxLength) return;
 		return { value: text };
 	}
+	get inputMode() {
+		return this.constraints.inputMode;
+	}
 	get limit() {
 		return this.maxLength;
 	}
@@ -7759,6 +7793,7 @@ var CanvasUI = class {
 	focusNode;
 	factor;
 	dirty = true;
+	measure;
 	projectionDirty = true;
 	baseBounds = /* @__PURE__ */ new WeakMap();
 	moving = /* @__PURE__ */ new Set();
@@ -7841,8 +7876,12 @@ var CanvasUI = class {
 	/** Logical focus; Hosts mirror it to native controls where available. */
 	focus(node) {
 		if (this.disposed) throw new EngineError("OWNER_DISPOSED", "UI has been disposed");
+		this.syncFocusLayout();
 		if (node && !this.canFocus(node)) throw new EngineError("UI_OWNERSHIP", "Focus requires a reachable interactive node in this UI");
-		if (this.focusNode === node) return;
+		if (this.focusNode === node) {
+			if (node) this.reveal(node);
+			return;
+		}
 		const previous = this.focusNode;
 		this.focusNode = node;
 		if (previous) {
@@ -7858,6 +7897,7 @@ var CanvasUI = class {
 	}
 	/** Ordered traversal, including offscreen controls. Undefined leaves focus at the boundary. */
 	focusNext(reverse = false) {
+		this.syncFocusLayout();
 		const order = [];
 		this.walk((node) => {
 			if (this.canFocus(node)) order.push(node);
@@ -7867,6 +7907,10 @@ var CanvasUI = class {
 		if (node) this.focus(node);
 		return node;
 	}
+	/** Reuse the Host's last metrics after a dynamic form/list mutation. */
+	syncFocusLayout() {
+		if (this.measure && (this.dirty || this.projectionDirty)) this.layout(this.width, this.height, this.measure);
+	}
 	/** Project scroll reveal before testing clips; static clipped controls must not trap Tab. */
 	canFocus(node) {
 		if (node.ui !== this || !node.available || !node.interactive || node.style.pointerEvents !== "auto") return false;
@@ -7948,6 +7992,7 @@ var CanvasUI = class {
 		}
 	}
 	/** @internal */ invalidate(layout = false) {
+		if (this.disposed) return;
 		if (this.focusNode && (this.focusNode.ui !== this || !this.focusNode.available)) this.focus();
 		for (const node of this.moving) if (node.ui !== this || !node.available || !node.style.inertia) {
 			this.moving.delete(node);
@@ -7959,6 +8004,7 @@ var CanvasUI = class {
 	/** @internal Rendering supplies exact text metrics; unchanged frames do no layout. */
 	layout(width, height, measure) {
 		if (this.disposed) return false;
+		this.measure = measure;
 		const geometry = this.dirty || this.width !== width || this.height !== height;
 		if (!geometry && !this.projectionDirty) return false;
 		if (geometry) {
@@ -8112,6 +8158,7 @@ var CanvasUI = class {
 				this.removeScene = void 0;
 				this.nodes = 0;
 				this.errors = () => {};
+				this.measure = void 0;
 			}
 		], "Canvas UI cleanup failed");
 	}