@almadar/ui 5.70.0 → 5.71.0

package/dist/components/core/organisms/CustomPattern.d.ts

@@ -8,7 +8,7 @@
  * @packageDocumentation
  */
 import React from "react";
-import type { AssetUrl, EventKey, EventPayload } from "@almadar/core";
+import type { AssetUrl, EventKey, EventPayload, JsonValue } from "@almadar/core";
 import type { UiError } from "../atoms/types";
 /**
  * Allowed element types for custom patterns.
@@ -49,7 +49,7 @@ export interface CustomPatternProps {
     /** Disabled state */
     disabled?: boolean;
     /** Additional HTML attributes */
-    htmlProps?: Record<string, unknown>;
+    htmlProps?: React.HTMLAttributes<HTMLElement>;
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
@@ -91,12 +91,11 @@ export interface CustomPatternConfig {
     href?: string;
     external?: boolean;
     disabled?: boolean;
-    [key: string]: unknown;
 }
 /**
  * Check if a pattern config is a custom pattern.
  */
-export declare function isCustomPatternConfig(config: unknown): config is CustomPatternConfig;
+export declare function isCustomPatternConfig(config: JsonValue | CustomPatternConfig): config is CustomPatternConfig;
 /**
  * Recursively render custom pattern configurations.
  *

package/dist/components/core/organisms/DataTable.d.ts

@@ -2,7 +2,7 @@ import React from "react";
 import type { EventKey } from "@almadar/core";
 import type { IconInput } from "../atoms/Icon";
 import { DisplayStateProps } from "./types";
-import type { EntityRow } from "@almadar/core";
+import type { EntityRow, FieldValue } from "@almadar/core";
 export type EntityTableLook = "dense" | "spacious" | "striped" | "borderless" | "card-rows";
 export interface Column<T> {
     key: keyof T | string;
@@ -13,7 +13,7 @@ export interface Column<T> {
     label?: string;
     width?: string;
     sortable?: boolean;
-    render?: (value: unknown, row: T, index: number) => React.ReactNode;
+    render?: (value: FieldValue | undefined, row: T, index: number) => React.ReactNode;
 }
 export interface RowAction<T> {
     label: string;

package/dist/components/core/organisms/DetailPanel.d.ts

@@ -65,7 +65,7 @@ export interface DetailPanelProps extends DisplayStateProps {
     /** Alias for fields - backwards compatibility */
     fieldNames?: readonly string[];
     /** Initial data for edit mode (passed by compiler) */
-    initialData?: Record<string, unknown> | unknown;
+    initialData?: EntityRow;
     /** Display mode (passed by compiler) */
     mode?: string;
     /** Panel position (for drawer/sidebar placement) */

package/dist/components/core/organisms/Form.d.ts

@@ -12,7 +12,7 @@
  * - Nested sections with collapsible support
  */
 import React from "react";
-import type { EventKey, FieldValue } from "@almadar/core";
+import type { EntityRow, EventKey, FieldValue, JsonObject } from "@almadar/core";
 import { type SelectOption } from "../atoms/Select";
 import { type RelationOption } from "../molecules/RelationSelect";
 import type { OrbitalEntity } from "@almadar/core";
@@ -27,10 +27,10 @@ export type SExpression = SExpr;
  * Form-specific evaluation context
  */
 export interface FormEvaluationContext {
-    formValues: Record<string, unknown>;
-    globalVariables: Record<string, unknown>;
-    localVariables?: Record<string, unknown>;
-    entity?: Record<string, unknown>;
+    formValues: EntityRow;
+    globalVariables: Record<string, FieldValue>;
+    localVariables?: Record<string, FieldValue>;
+    entity?: EntityRow;
 }
 /**
  * Hidden calculation definition
@@ -117,7 +117,7 @@ export interface SchemaField {
     /** Whether field is required */
     required?: boolean;
     /** Default value */
-    defaultValue?: unknown;
+    defaultValue?: FieldValue;
     /** Options for select/enum fields - accepts readonly for generated const arrays */
     options?: readonly SelectOption[];
     /** Enum values (alternative to options, just strings) - accepts readonly for generated const arrays */
@@ -131,7 +131,7 @@ export interface SchemaField {
     /** Pattern for validation */
     pattern?: string;
     /** Validation rules */
-    validation?: Record<string, unknown>;
+    validation?: JsonObject;
     /** Whether field is readonly (displays value but cannot edit) */
     readonly?: boolean;
     /** Whether field is disabled (alternative to readonly for compatibility) */
@@ -156,7 +156,7 @@ export interface FormProps extends Omit<React.FormHTMLAttributes<HTMLFormElement
     /** Additional CSS classes */
     className?: string;
     /** Entity type name or schema object. When OrbitalEntity, fields are auto-derived if not provided. */
-    entity?: string | OrbitalEntity | readonly Record<string, unknown>[];
+    entity?: string | OrbitalEntity | EntityRow | readonly EntityRow[];
     /**
      * Form mode — 'create' for new records, 'edit' for updating existing.
      * Accepts `string` so schema-driven callers (whose `config.mode` is typed
@@ -167,7 +167,7 @@ export interface FormProps extends Omit<React.FormHTMLAttributes<HTMLFormElement
     /** Fields definition (schema format) - accepts readonly for generated const arrays */
     fields: readonly Readonly<SchemaField>[];
     /** Initial form data */
-    initialData?: Record<string, unknown> | unknown;
+    initialData?: EntityRow;
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
@@ -196,8 +196,8 @@ export interface FormProps extends Omit<React.FormHTMLAttributes<HTMLFormElement
     hiddenCalculations?: HiddenCalculation[] | boolean;
     /** Violation conditions that emit VIOLATION_DETECTED when met (boolean true means enabled but config loaded separately) */
     violationTriggers?: ViolationTrigger[] | boolean;
-    /** Context for S-expression evaluation - accepts flexible types from generated code */
-    evaluationContext?: FormEvaluationContext | Record<string, unknown>;
+    /** Context for S-expression evaluation */
+    evaluationContext?: FormEvaluationContext;
     /** Nested form sections with optional conditions */
     sections?: FormSection[];
     /** Callback when any field value changes */

package/dist/components/core/organisms/List.d.ts

@@ -17,11 +17,10 @@
  * - No internal search/filter state — trait provides filtered data
  */
 import React from "react";
-import type { AssetUrl, EventKey } from "@almadar/core";
+import type { AssetUrl, EventKey, FieldValue, EntityRow } from "@almadar/core";
 import type { IconInput } from "../atoms/Icon";
 import { type MenuItem } from "../molecules/Menu";
 import type { DisplayStateProps } from "./types";
-import type { EntityRow } from "@almadar/core";
 export type ListItem = {
     id: string;
     title?: string;
@@ -37,8 +36,7 @@ export type ListItem = {
     onClick?: () => void;
     disabled?: boolean;
     completed?: boolean;
-    [key: string]: unknown;
-    _fields?: Record<string, unknown>;
+    _fields?: Record<string, FieldValue | undefined>;
 };
 export interface SchemaItemAction {
     label: string;
@@ -51,7 +49,7 @@ export interface SchemaItemAction {
     action?: EventKey;
     variant?: "primary" | "secondary" | "ghost" | "danger" | "default";
     /** Click handler from generated code */
-    onClick?: (row: unknown) => void;
+    onClick?: (row: EntityRow) => void;
 }
 /**
  * Field definition - can be a simple string or object with key/header or name/label

package/dist/components/core/organisms/StatCard.d.ts

@@ -25,8 +25,8 @@ export interface StatCardProps extends DisplayStateProps {
     label?: string;
     /** Title (alias for label) */
     title?: string;
-    /** Primary value - accepts array/unknown from generated code (will use first element or length) */
-    value?: string | number | (string | number | undefined)[] | unknown;
+    /** Primary value - accepts array from generated code (will use first element or length) */
+    value?: string | number | (string | number | undefined)[];
     /** Previous value for comparison */
     previousValue?: number;
     /** Current value as number for trend calculation */

package/dist/components/core/organisms/book/types.d.ts

@@ -59,4 +59,4 @@ export declare function resolveFieldMap(fieldMap: BookFieldMap | string | undefi
  * chapter data come back as `EntityRow`s; the per-chapter `OrbitalSchema` is
  * lifted off into `schemaByChapterId`.
  */
-export declare function mapBookData(raw: Record<string, unknown>, fields?: BookFieldMap): NormalizedBook;
+export declare function mapBookData(raw: EntityRow, fields?: BookFieldMap): NormalizedBook;

package/dist/components/core/organisms/debug/RuntimeDebugger.d.ts

@@ -1,3 +1,4 @@
+import type { OrbitalSchema } from '@almadar/core';
 import './RuntimeDebugger.css';
 export interface RuntimeDebuggerProps {
     /** Initial position */
@@ -11,7 +12,7 @@ export interface RuntimeDebuggerProps {
     /** Default active tab id */
     defaultTab?: string;
     /** Raw schema for EventDispatcherTab payload extraction */
-    schema?: Record<string, unknown>;
+    schema?: OrbitalSchema;
 }
 export declare function RuntimeDebugger({ position, defaultCollapsed, className, mode, defaultTab, schema, }: RuntimeDebuggerProps): import("react/jsx-runtime").JSX.Element | null;
 export declare namespace RuntimeDebugger {

package/dist/components/core/organisms/debug/tabs/EventDispatcherTab.d.ts

@@ -4,10 +4,11 @@
  * Shows available transitions per trait based on current state,
  * lets users click to fire events, and displays a compact transition log.
  */
+import type { OrbitalSchema } from '@almadar/core';
 import type { TraitDebugInfo } from '../../../../../lib/traitRegistry';
 interface EventDispatcherTabProps {
     traits: TraitDebugInfo[];
-    schema?: Record<string, unknown>;
+    schema?: OrbitalSchema;
 }
 export declare function EventDispatcherTab({ traits, schema }: EventDispatcherTabProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace EventDispatcherTab {

package/dist/components/core/organisms/layout/DashboardGrid.d.ts

@@ -17,8 +17,6 @@ export interface DashboardGridCell {
     colSpan?: 1 | 2 | 3 | 4;
     /** Number of rows this cell spans (1-2) */
     rowSpan?: 1 | 2;
-    /** Allow additional schema-driven properties */
-    [key: string]: unknown;
 }
 export interface DashboardGridProps extends DisplayStateProps {
     /** Number of columns */

package/dist/components/core/organisms/types.d.ts

@@ -7,6 +7,7 @@
  * Exception: Form manages local `formData` state for field input tracking.
  * This is the ONE allowed exception — documented here.
  */
+import type { FieldValue } from '@almadar/core';
 import type { UiError } from '../atoms/types';
 export type { UiError };
 export declare const EntityDisplayEvents: {
@@ -32,7 +33,7 @@ export interface SearchPayload {
 export interface FilterPayload {
     field: string;
     operator: string;
-    value: unknown;
+    value: FieldValue;
 }
 export interface SelectPayload {
     ids: (string | number)[];
@@ -65,7 +66,7 @@ export interface DisplayStateProps {
     /** Total number of items (for pagination display) */
     totalCount?: number;
     /** Active filters */
-    activeFilters?: Record<string, unknown>;
+    activeFilters?: Record<string, FieldValue>;
     /** Currently selected item IDs */
     selectedIds?: readonly (string | number)[];
 }

package/dist/components/game/atoms/ScoreDisplay.d.ts

@@ -5,6 +5,8 @@ export interface ScoreDisplayProps {
     assetUrl?: AssetUrl;
     /** Current score value */
     value: number;
+    /** Alias for value — common schema binding name */
+    score?: number;
     /** Label to display before score */
     label?: string;
     /** Icon component or emoji */
@@ -18,7 +20,7 @@ export interface ScoreDisplayProps {
     /** Number formatting locale */
     locale?: string;
 }
-export declare function ScoreDisplay({ assetUrl, value, label, icon, size, className, animated, locale, ...rest }: ScoreDisplayProps & Record<string, unknown>): import("react/jsx-runtime").JSX.Element;
+export declare function ScoreDisplay({ assetUrl, value, score, label, icon, size, className, animated, locale, }: ScoreDisplayProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace ScoreDisplay {
     var displayName: string;
 }

package/dist/components/game/molecules/three/hooks/useSceneGraph.d.ts

@@ -1,4 +1,5 @@
 import * as THREE from 'three';
+import type { JsonObject } from '@almadar/core';
 export type NodeType = 'tile' | 'unit' | 'feature' | 'highlight' | 'effect';
 export interface SceneGraphNode {
     /** Unique node identifier */
@@ -19,7 +20,7 @@ export interface SceneGraphNode {
         z: number;
     };
     /** Optional metadata */
-    metadata?: Record<string, unknown>;
+    metadata?: JsonObject;
 }
 export interface UseSceneGraphReturn {
     /** Reference to the nodes map */

package/dist/components/game/molecules/three/index.cjs

@@ -3989,6 +3989,9 @@ var iconSizeStyles = {
   md: "h-icon-default w-icon-default",
   lg: "h-icon-default w-icon-default"
 };
+function isIconLike(v) {
+  return typeof v.render === "function";
+}
 function resolveIconProp(value, sizeClass) {
   if (!value) return null;
   if (typeof value === "string") {
@@ -4001,7 +4004,7 @@ function resolveIconProp(value, sizeClass) {
   if (React11__default.default.isValidElement(value)) {
     return value;
   }
-  if (typeof value === "object" && value !== null && "render" in value) {
+  if (typeof value === "object" && value !== null && isIconLike(value)) {
     const IconComp = value;
     return /* @__PURE__ */ jsxRuntime.jsx(IconComp, { className: sizeClass });
   }
@@ -4023,6 +4026,7 @@ var Button = React11__default.default.forwardRef(
     label,
     children,
     onClick,
+    "data-testid": dataTestId,
     ...props
   }, ref) => {
     const eventBus = useEventBus();
@@ -4055,7 +4059,7 @@ var Button = React11__default.default.forwardRef(
         ),
         onClick: handleClick,
         ...props,
-        "data-testid": props["data-testid"] ?? (action ? `action-${action}` : void 0),
+        "data-testid": dataTestId ?? (action ? `action-${action}` : void 0),
         children: [
           isLoading ? /* @__PURE__ */ jsxRuntime.jsx(LucideIcons.Loader2, { className: "h-icon-default w-icon-default animate-spin" }) : resolvedLeftIcon && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex-shrink-0", children: resolvedLeftIcon }),
           children || label,
@@ -4152,9 +4156,8 @@ var Typography = ({
 }) => {
   const variant = variantProp ?? (level ? `h${level}` : "body1");
   const Component2 = as || defaultElements[variant];
-  const Comp = Component2;
-  return /* @__PURE__ */ jsxRuntime.jsx(
-    Comp,
+  return React11__default.default.createElement(
+    Component2,
     {
       id,
       className: cn(
@@ -4167,9 +4170,9 @@ var Typography = ({
         overflow && overflowStyles[overflow],
         className
       ),
-      style,
-      children: children ?? content
-    }
+      style
+    },
+    children ?? content
   );
 };
 Typography.displayName = "Typography";
@@ -4226,9 +4229,8 @@ var Stack = ({
   };
   const isHorizontal = direction === "horizontal";
   const directionClass = responsive && isHorizontal ? reverse ? "flex-col-reverse md:flex-row-reverse" : "flex-col md:flex-row" : isHorizontal ? reverse ? "flex-row-reverse" : "flex-row" : reverse ? "flex-col-reverse" : "flex-col";
-  const Comp = Component2;
-  return /* @__PURE__ */ jsxRuntime.jsx(
-    Comp,
+  return React11__default.default.createElement(
+    Component2,
     {
       className: cn(
         "flex",
@@ -4244,9 +4246,9 @@ var Stack = ({
       onClick: action || onClick ? handleClick : void 0,
       onKeyDown,
       role,
-      tabIndex,
-      children
-    }
+      tabIndex
+    },
+    children
   );
 };
 var VStack = (props) => /* @__PURE__ */ jsxRuntime.jsx(Stack, { direction: "vertical", ...props });
@@ -5163,9 +5165,17 @@ function getEntity(orbital) {
   if (typeof entity === "string") {
     return { name: entity, fields: [], persistence: "runtime" };
   }
+  if ("extends" in entity) {
+    const ec = entity;
+    return {
+      name: ec.name ?? orbital.name,
+      fields: ec.fields ?? [],
+      persistence: ec.persistence ?? "runtime"
+    };
+  }
   const e = entity;
   return {
-    name: e.name ?? orbital.name,
+    name: e.name,
     fields: e.fields ?? [],
     persistence: e.persistence ?? "runtime"
   };
@@ -5174,6 +5184,7 @@ function getTraits(orbital) {
   if (!orbital.traits) return [];
   return orbital.traits.map((t) => {
     if (typeof t === "string") return { name: t };
+    if ("ref" in t && !("stateMachine" in t)) return { name: t.name ?? t.ref };
     return t;
   });
 }
@@ -5181,6 +5192,7 @@ function getPages(orbital) {
   if (!orbital.pages) return [];
   return orbital.pages.map((p) => {
     if (typeof p === "string") return { name: p, path: `/${p.toLowerCase()}` };
+    if ("ref" in p && !("path" in p)) return { name: p.ref, path: `/${p.ref.toLowerCase()}` };
     return p;
   });
 }
@@ -5199,12 +5211,12 @@ function getEvents(sm) {
 function getEmits(trait) {
   const emits = trait.emits;
   if (!emits) return [];
-  return emits.map((e) => typeof e === "string" ? e : e.event ?? e.name ?? "");
+  return emits.map((e) => e.event ?? "");
 }
 function getListens(trait) {
   const listens = trait.listens;
   if (!listens) return [];
-  return listens.map((l) => typeof l === "string" ? l : l.event ?? "");
+  return listens.map((l) => l.event ?? "");
 }
 function parseEffectType(effect) {
   if (Array.isArray(effect)) {
@@ -5375,14 +5387,14 @@ function parseTraitLevel(schema, orbitalName, traitName) {
   if (!sm) return null;
   const states = getStates(sm).map((s) => ({
     name: s.name ?? "",
-    isInitial: s.isInitial ?? false,
-    isTerminal: s.isTerminal ?? false
+    isInitial: s.isInitial ?? null,
+    isTerminal: s.isTerminal ?? null
   }));
   const transitions = getTransitions(sm).map((t, i) => ({
     from: t.from ?? "",
     to: t.to ?? "",
     event: t.event ?? "",
-    guard: t.guard,
+    guard: t.guard ?? null,
     effects: (t.effects ?? []).map(parseEffectType),
     index: i
   }));
@@ -5401,13 +5413,14 @@ function parseTransitionLevel(schema, orbitalName, traitName, transitionIndex) {
   if (!traitData) return null;
   const transition = traitData.transitions[transitionIndex];
   if (!transition) return null;
-  const guard = transition.guard ? exprToTree(transition.guard) : null;
+  const guardVal = transition.guard;
+  const guard = guardVal != null ? exprToTree(guardVal) : null;
   const effects = transition.effects.map(
     (e) => exprToTree([e.type, ...e.args])
   );
   const slotTargets = transition.effects.filter((e) => e.type === "render-ui").map((e) => ({
     name: String(e.args[0] ?? "main"),
-    pattern: typeof e.args[1] === "object" && e.args[1] !== null ? e.args[1].type ?? "unknown" : String(e.args[1] ?? "unknown")
+    pattern: typeof e.args[1] === "object" && e.args[1] !== null && !Array.isArray(e.args[1]) ? e.args[1].type ?? "unknown" : String(e.args[1] ?? "unknown")
   }));
   return {
     from: transition.from,
@@ -6870,8 +6883,8 @@ var Avl3DTraitScene = ({
         Avl3DStateNode,
         {
           name: state.name,
-          isInitial: state.isInitial,
-          isTerminal: state.isTerminal,
+          isInitial: state.isInitial ?? void 0,
+          isTerminal: state.isTerminal ?? void 0,
           position: pos,
           incomingCount: transitionCounts.incoming.get(state.name) ?? 0,
           outgoingCount: transitionCounts.outgoing.get(state.name) ?? 0

package/dist/components/game/molecules/three/index.js

@@ -3965,6 +3965,9 @@ var iconSizeStyles = {
   md: "h-icon-default w-icon-default",
   lg: "h-icon-default w-icon-default"
 };
+function isIconLike(v) {
+  return typeof v.render === "function";
+}
 function resolveIconProp(value, sizeClass) {
   if (!value) return null;
   if (typeof value === "string") {
@@ -3977,7 +3980,7 @@ function resolveIconProp(value, sizeClass) {
   if (React11.isValidElement(value)) {
     return value;
   }
-  if (typeof value === "object" && value !== null && "render" in value) {
+  if (typeof value === "object" && value !== null && isIconLike(value)) {
     const IconComp = value;
     return /* @__PURE__ */ jsx(IconComp, { className: sizeClass });
   }
@@ -3999,6 +4002,7 @@ var Button = React11.forwardRef(
     label,
     children,
     onClick,
+    "data-testid": dataTestId,
     ...props
   }, ref) => {
     const eventBus = useEventBus();
@@ -4031,7 +4035,7 @@ var Button = React11.forwardRef(
         ),
         onClick: handleClick,
         ...props,
-        "data-testid": props["data-testid"] ?? (action ? `action-${action}` : void 0),
+        "data-testid": dataTestId ?? (action ? `action-${action}` : void 0),
         children: [
           isLoading ? /* @__PURE__ */ jsx(Loader2, { className: "h-icon-default w-icon-default animate-spin" }) : resolvedLeftIcon && /* @__PURE__ */ jsx("span", { className: "flex-shrink-0", children: resolvedLeftIcon }),
           children || label,
@@ -4128,9 +4132,8 @@ var Typography = ({
 }) => {
   const variant = variantProp ?? (level ? `h${level}` : "body1");
   const Component2 = as || defaultElements[variant];
-  const Comp = Component2;
-  return /* @__PURE__ */ jsx(
-    Comp,
+  return React11.createElement(
+    Component2,
     {
       id,
       className: cn(
@@ -4143,9 +4146,9 @@ var Typography = ({
         overflow && overflowStyles[overflow],
         className
       ),
-      style,
-      children: children ?? content
-    }
+      style
+    },
+    children ?? content
   );
 };
 Typography.displayName = "Typography";
@@ -4202,9 +4205,8 @@ var Stack = ({
   };
   const isHorizontal = direction === "horizontal";
   const directionClass = responsive && isHorizontal ? reverse ? "flex-col-reverse md:flex-row-reverse" : "flex-col md:flex-row" : isHorizontal ? reverse ? "flex-row-reverse" : "flex-row" : reverse ? "flex-col-reverse" : "flex-col";
-  const Comp = Component2;
-  return /* @__PURE__ */ jsx(
-    Comp,
+  return React11.createElement(
+    Component2,
     {
       className: cn(
         "flex",
@@ -4220,9 +4222,9 @@ var Stack = ({
       onClick: action || onClick ? handleClick : void 0,
       onKeyDown,
       role,
-      tabIndex,
-      children
-    }
+      tabIndex
+    },
+    children
   );
 };
 var VStack = (props) => /* @__PURE__ */ jsx(Stack, { direction: "vertical", ...props });
@@ -5139,9 +5141,17 @@ function getEntity(orbital) {
   if (typeof entity === "string") {
     return { name: entity, fields: [], persistence: "runtime" };
   }
+  if ("extends" in entity) {
+    const ec = entity;
+    return {
+      name: ec.name ?? orbital.name,
+      fields: ec.fields ?? [],
+      persistence: ec.persistence ?? "runtime"
+    };
+  }
   const e = entity;
   return {
-    name: e.name ?? orbital.name,
+    name: e.name,
     fields: e.fields ?? [],
     persistence: e.persistence ?? "runtime"
   };
@@ -5150,6 +5160,7 @@ function getTraits(orbital) {
   if (!orbital.traits) return [];
   return orbital.traits.map((t) => {
     if (typeof t === "string") return { name: t };
+    if ("ref" in t && !("stateMachine" in t)) return { name: t.name ?? t.ref };
     return t;
   });
 }
@@ -5157,6 +5168,7 @@ function getPages(orbital) {
   if (!orbital.pages) return [];
   return orbital.pages.map((p) => {
     if (typeof p === "string") return { name: p, path: `/${p.toLowerCase()}` };
+    if ("ref" in p && !("path" in p)) return { name: p.ref, path: `/${p.ref.toLowerCase()}` };
     return p;
   });
 }
@@ -5175,12 +5187,12 @@ function getEvents(sm) {
 function getEmits(trait) {
   const emits = trait.emits;
   if (!emits) return [];
-  return emits.map((e) => typeof e === "string" ? e : e.event ?? e.name ?? "");
+  return emits.map((e) => e.event ?? "");
 }
 function getListens(trait) {
   const listens = trait.listens;
   if (!listens) return [];
-  return listens.map((l) => typeof l === "string" ? l : l.event ?? "");
+  return listens.map((l) => l.event ?? "");
 }
 function parseEffectType(effect) {
   if (Array.isArray(effect)) {
@@ -5351,14 +5363,14 @@ function parseTraitLevel(schema, orbitalName, traitName) {
   if (!sm) return null;
   const states = getStates(sm).map((s) => ({
     name: s.name ?? "",
-    isInitial: s.isInitial ?? false,
-    isTerminal: s.isTerminal ?? false
+    isInitial: s.isInitial ?? null,
+    isTerminal: s.isTerminal ?? null
   }));
   const transitions = getTransitions(sm).map((t, i) => ({
     from: t.from ?? "",
     to: t.to ?? "",
     event: t.event ?? "",
-    guard: t.guard,
+    guard: t.guard ?? null,
     effects: (t.effects ?? []).map(parseEffectType),
     index: i
   }));
@@ -5377,13 +5389,14 @@ function parseTransitionLevel(schema, orbitalName, traitName, transitionIndex) {
   if (!traitData) return null;
   const transition = traitData.transitions[transitionIndex];
   if (!transition) return null;
-  const guard = transition.guard ? exprToTree(transition.guard) : null;
+  const guardVal = transition.guard;
+  const guard = guardVal != null ? exprToTree(guardVal) : null;
   const effects = transition.effects.map(
     (e) => exprToTree([e.type, ...e.args])
   );
   const slotTargets = transition.effects.filter((e) => e.type === "render-ui").map((e) => ({
     name: String(e.args[0] ?? "main"),
-    pattern: typeof e.args[1] === "object" && e.args[1] !== null ? e.args[1].type ?? "unknown" : String(e.args[1] ?? "unknown")
+    pattern: typeof e.args[1] === "object" && e.args[1] !== null && !Array.isArray(e.args[1]) ? e.args[1].type ?? "unknown" : String(e.args[1] ?? "unknown")
   }));
   return {
     from: transition.from,
@@ -6846,8 +6859,8 @@ var Avl3DTraitScene = ({
         Avl3DStateNode,
         {
           name: state.name,
-          isInitial: state.isInitial,
-          isTerminal: state.isTerminal,
+          isInitial: state.isInitial ?? void 0,
+          isTerminal: state.isTerminal ?? void 0,
           position: pos,
           incomingCount: transitionCounts.incoming.get(state.name) ?? 0,
           outgoingCount: transitionCounts.outgoing.get(state.name) ?? 0

package/dist/components/game/organisms/PinballBoard.d.ts

@@ -1,13 +1,13 @@
 import React from 'react';
-import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
 import type { DisplayStateProps } from '../../core/organisms/types';
 export interface PinballBoardProps extends DisplayStateProps {
     /** Playfield tiles */
-    tiles?: unknown[];
+    tiles?: readonly EntityRow[];
     /** Ball units on the board */
-    units?: unknown[];
+    units?: readonly EntityRow[];
     /** Features (bumpers, paddles, etc.) on the board */
-    features?: unknown[];
+    features?: readonly EntityRow[];
     /** Asset sprite manifest */
     assetManifest?: string;
     /** Base URL prepended to manifest sprite paths */