aeon-ui-engine 1.4.0 → 1.8.0

package/packages/tree/dist/index.d.ts

@@ -0,0 +1,97 @@
+import { ReactNode } from 'react';
+
+/**
+ * A widget is configuration, the way a Flutter `Widget` is: immutable data
+ * describing one face of a chart. It holds no lifecycle. The only state it
+ * may name is a snapshot already produced by a machine (`data-aeon-state`).
+ *
+ * Callbacks are event bindings (what to send), not state. There is no
+ * equivalent of `StatefulWidget` or `setState` — a second copy of the chart
+ * living in the tree would be the boolean twin this layer exists to remove.
+ */
+type Widget = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'host';
+    id: string;
+} | {
+    type: 'el';
+    tag: 'div' | 'form' | 'button' | 'p' | 'span';
+    scope?: string;
+    part?: string;
+    /** Chart snapshot token. Projected onto `data-aeon-state`. */
+    state?: string;
+    className?: string;
+    buttonType?: 'button' | 'submit';
+    disabled?: boolean;
+    role?: string;
+    onSubmit?: (event: {
+        preventDefault(): void;
+    }) => void;
+    onClick?: () => void;
+    children: Widget[];
+};
+declare const text: (value: string) => Widget;
+declare const host: (id: string) => Widget;
+
+/**
+ * The chart every "click, maybe confirm, await, succeed or fail" region
+ * shares. One region, four faces — not a `busy` boolean beside the markup.
+ */
+declare const EXCLUSIVE_ACTION_STATES: readonly ["idle", "confirming", "busy", "failure"];
+type ExclusiveActionState = (typeof EXCLUSIVE_ACTION_STATES)[number];
+type ExclusiveActionInput = {
+    scope: string;
+    part: string;
+    /** Active snapshot token, usually `stateToAttr(snapshot.value)`. */
+    state: string;
+    busy: boolean;
+    error: string | null;
+    className?: string;
+    tag?: 'form' | 'div';
+    /** Panel-specific fields. A host, so the tree stays generic. */
+    body: Widget;
+    idleLabel: string;
+    pendingLabel: string;
+    primaryClassName?: string;
+    primaryDisabled?: boolean;
+    onSubmit?: (event: {
+        preventDefault(): void;
+    }) => void;
+    secondary?: {
+        label: string;
+        className?: string;
+        disabled?: boolean;
+        onClick: () => void;
+    };
+    actionsClassName?: string;
+    /** When set, the `confirm` host is mounted. The app renders its Prompt there. */
+    confirm?: boolean;
+};
+/**
+ * One widget for an exclusive mutation. The root carries the chart state;
+ * the primary label and the disabled set are functions of `busy`, and the
+ * failure copy is a child that exists only when `error` is set.
+ */
+declare function exclusiveActionWidget(input: ExclusiveActionInput): Widget;
+
+type WidgetHosts = Record<string, () => ReactNode>;
+/**
+ * Element layer: turn a widget tree into DOM. Anatomy comes from
+ * `@aeon-ui/core`, so product CSS restyles `data-aeon-*` and nothing else
+ * is introduced. Hosts are the escape for existing compounds (Prompt, a
+ * password field) — the tree names the slot, the app supplies the compound.
+ */
+declare function interpret(widget: Widget, hosts: WidgetHosts): ReactNode;
+
+/** Every `data-aeon-state` token a tree would project. */
+declare function widgetStates(widget: Widget): string[];
+/**
+ * States the chart names that the projection never puts on the tree.
+ * Totality (PHILOSOPHY.md §2): if the machine has the state, the face for
+ * that state must carry it. A missing name is a face the UI forgot.
+ */
+declare function uncoveredStates(states: readonly string[], project: (state: string) => Widget): string[];
+
+export { EXCLUSIVE_ACTION_STATES, type ExclusiveActionInput, type ExclusiveActionState, type Widget, type WidgetHosts, exclusiveActionWidget, host, interpret, text, uncoveredStates, widgetStates };

package/packages/tree/dist/index.js

@@ -0,0 +1,107 @@
+// src/widget.ts
+var text = (value) => ({ type: "text", text: value });
+var host = (id) => ({ type: "host", id });
+
+// src/exclusive-action.ts
+var EXCLUSIVE_ACTION_STATES = ["idle", "confirming", "busy", "failure"];
+function exclusiveActionWidget(input) {
+  const children = [input.body];
+  if (input.error) {
+    children.push({
+      type: "el",
+      tag: "p",
+      part: "error",
+      className: "error",
+      role: "alert",
+      children: [text(input.error)]
+    });
+  }
+  const actions = [
+    {
+      type: "el",
+      tag: "button",
+      part: "primary",
+      buttonType: input.tag === "div" ? "button" : "submit",
+      disabled: input.busy || input.primaryDisabled,
+      className: input.primaryClassName,
+      onClick: input.tag === "div" ? () => input.onSubmit?.({ preventDefault() {
+      } }) : void 0,
+      children: [text(input.busy ? input.pendingLabel : input.idleLabel)]
+    }
+  ];
+  if (input.secondary) {
+    actions.push({
+      type: "el",
+      tag: "button",
+      part: "secondary",
+      buttonType: "button",
+      disabled: input.busy || input.secondary.disabled,
+      className: input.secondary.className,
+      onClick: input.secondary.onClick,
+      children: [text(input.secondary.label)]
+    });
+  }
+  children.push({
+    type: "el",
+    tag: "div",
+    part: "actions",
+    className: input.actionsClassName,
+    state: input.state,
+    children: actions
+  });
+  if (input.confirm) children.push(host("confirm"));
+  return {
+    type: "el",
+    tag: input.tag ?? "form",
+    scope: input.scope,
+    part: input.part,
+    state: input.state,
+    className: input.className,
+    onSubmit: input.tag === "div" ? void 0 : input.onSubmit,
+    children
+  };
+}
+
+// src/interpret.tsx
+import { partOnlyAttrs, scopeAttrs } from "@aeon-ui/core";
+import { createElement, Fragment } from "react";
+function interpret(widget, hosts) {
+  if (widget.type === "text") return widget.text;
+  if (widget.type === "host") return hosts[widget.id]?.() ?? null;
+  const attrs = widget.scope ? scopeAttrs(widget.scope, widget.part ?? "root", { state: widget.state }) : widget.part ? partOnlyAttrs(widget.part, { state: widget.state }) : widget.state ? { "data-aeon-state": widget.state } : {};
+  const props = {
+    ...attrs,
+    className: widget.className,
+    role: widget.role,
+    disabled: widget.disabled || void 0,
+    type: widget.tag === "button" ? widget.buttonType ?? "button" : void 0,
+    onSubmit: widget.tag === "form" && widget.onSubmit ? (event) => widget.onSubmit?.(event) : void 0,
+    onClick: widget.onClick
+  };
+  return createElement(
+    widget.tag,
+    props,
+    ...widget.children.map(
+      (child, index) => createElement(Fragment, { key: index }, interpret(child, hosts))
+    )
+  );
+}
+
+// src/totality.ts
+function widgetStates(widget) {
+  if (widget.type !== "el") return [];
+  const own = widget.state ? [widget.state] : [];
+  return [...own, ...widget.children.flatMap(widgetStates)];
+}
+function uncoveredStates(states, project) {
+  return states.filter((state) => !widgetStates(project(state)).includes(state));
+}
+export {
+  EXCLUSIVE_ACTION_STATES,
+  exclusiveActionWidget,
+  host,
+  interpret,
+  text,
+  uncoveredStates,
+  widgetStates
+};

package/packages/tree/node_modules/.bin/esbuild

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/esbuild@0.28.0/node_modules/esbuild/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/esbuild@0.28.0/node_modules/esbuild/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/esbuild@0.28.0/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/esbuild@0.28.0/node_modules/esbuild/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/esbuild@0.28.0/node_modules/esbuild/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/esbuild@0.28.0/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../node_modules/.pnpm/esbuild@0.28.0/node_modules/esbuild/bin/esbuild" "$@"
+else
+  exec node  "$basedir/../../../../node_modules/.pnpm/esbuild@0.28.0/node_modules/esbuild/bin/esbuild" "$@"
+fi

package/packages/tree/node_modules/.bin/jiti

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/jiti@2.7.0/node_modules/jiti/lib/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/jiti@2.7.0/node_modules/jiti/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/jiti@2.7.0/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/jiti@2.7.0/node_modules/jiti/lib/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/jiti@2.7.0/node_modules/jiti/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/jiti@2.7.0/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../node_modules/.pnpm/jiti@2.7.0/node_modules/jiti/lib/jiti-cli.mjs" "$@"
+else
+  exec node  "$basedir/../../../../node_modules/.pnpm/jiti@2.7.0/node_modules/jiti/lib/jiti-cli.mjs" "$@"
+fi

package/packages/tree/node_modules/.bin/tsc

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

package/packages/tree/node_modules/.bin/tsserver

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi

package/packages/tree/node_modules/.bin/tsup

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tsup/dist/cli-default.js" "$@"
+else
+  exec node  "$basedir/../tsup/dist/cli-default.js" "$@"
+fi

package/packages/tree/node_modules/.bin/tsup-node

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules/tsup/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.15_tsx@4.22.3_typescript@5.9.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tsup/dist/cli-node.js" "$@"
+else
+  exec node  "$basedir/../tsup/dist/cli-node.js" "$@"
+fi

package/packages/tree/node_modules/.bin/tsx

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/dist/cli.mjs" "$@"
+else
+  exec node  "$basedir/../../../../node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/dist/cli.mjs" "$@"
+fi

package/packages/tree/node_modules/.bin/vite

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules/vite/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules/vite/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules/vite/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules/vite/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules/vite/bin/vite.js" "$@"
+else
+  exec node  "$basedir/../../../../node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules/vite/bin/vite.js" "$@"
+fi

package/packages/tree/node_modules/.bin/vitest

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vitest@4.1.8_@types+node@22.19.19_jsdom@29.1.1_vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3_/node_modules/vitest/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vitest@4.1.8_@types+node@22.19.19_jsdom@29.1.1_vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3_/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vitest@4.1.8_@types+node@22.19.19_jsdom@29.1.1_vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3_/node_modules/vitest/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vitest@4.1.8_@types+node@22.19.19_jsdom@29.1.1_vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3_/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../vitest/vitest.mjs" "$@"
+else
+  exec node  "$basedir/../vitest/vitest.mjs" "$@"
+fi

package/packages/tree/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json

@@ -0,0 +1 @@
+{"version":"4.1.8","results":[[":src/exclusive-action.test.ts",{"duration":2.708500000000001,"failed":false}]]}

package/packages/tree/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@aeon-ui/tree",
+  "version": "0.1.0",
+  "description": "Widget trees: UI as data projected from a statechart snapshot. Flutter's Widget layer, Aeon's anatomy, no local state.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GenericCPU/aeon-ui.git",
+    "directory": "packages/tree"
+  },
+  "publishConfig": { "access": "public" },
+  "files": ["dist", "README.md"],
+  "keywords": ["aeon-ui", "statechart", "widget", "xstate"],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean --external react",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@aeon-ui/core": "workspace:*"
+  },
+  "peerDependencies": {
+    "react": "^18 || ^19"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.2",
+    "react": "^19.1.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.8"
+  }
+}

package/packages/tree/src/exclusive-action.test.ts

@@ -0,0 +1,54 @@
+import { describe, expect, it } from 'vitest'
+import { exclusiveActionWidget, EXCLUSIVE_ACTION_STATES } from './exclusive-action.js'
+import { uncoveredStates, widgetStates } from './totality.js'
+import { host } from './widget.js'
+
+const project = (state: string) =>
+  exclusiveActionWidget({
+    scope: 'example',
+    part: 'form',
+    state,
+    busy: state === 'busy' || state === 'confirming',
+    error: state === 'failure' ? 'nope' : null,
+    body: host('body'),
+    idleLabel: 'Save',
+    pendingLabel: 'Saving…',
+    onSubmit: () => {},
+    confirm: state === 'confirming',
+  })
+
+describe('exclusiveActionWidget', () => {
+  it('covers every state of the chart', () => {
+    expect(uncoveredStates(EXCLUSIVE_ACTION_STATES, project)).toEqual([])
+  })
+
+  it('shows the failure copy only on failure', () => {
+    expect(widgetStates(project('idle'))).not.toContain('failure')
+    const failure = project('failure')
+    const error = failure.type === 'el' && failure.children.find((c) => c.type === 'el' && c.part === 'error')
+    expect(error && error.type === 'el' && error.children[0]).toEqual({ type: 'text', text: 'nope' })
+  })
+
+  it('mounts the confirm host only while confirming', () => {
+    const confirming = project('confirming')
+    const idle = project('idle')
+    const hasConfirm = (tree: ReturnType<typeof project>) =>
+      tree.type === 'el' && tree.children.some((c) => c.type === 'host' && c.id === 'confirm')
+    expect(hasConfirm(confirming)).toBe(true)
+    expect(hasConfirm(idle)).toBe(false)
+  })
+
+  it('labels the primary from busy, and refuses a second click', () => {
+    const busy = project('busy')
+    const primary =
+      busy.type === 'el'
+        ? busy.children
+            .flatMap((c) => (c.type === 'el' ? c.children : []))
+            .find((c) => c.type === 'el' && c.part === 'primary')
+        : undefined
+    expect(primary && primary.type === 'el' && primary.disabled).toBe(true)
+    expect(primary && primary.type === 'el' && primary.children).toEqual([
+      { type: 'text', text: 'Saving…' },
+    ])
+  })
+})

package/packages/tree/src/exclusive-action.ts

@@ -0,0 +1,104 @@
+import { host, text, type Widget } from './widget.js'
+
+/**
+ * The chart every "click, maybe confirm, await, succeed or fail" region
+ * shares. One region, four faces — not a `busy` boolean beside the markup.
+ */
+export const EXCLUSIVE_ACTION_STATES = ['idle', 'confirming', 'busy', 'failure'] as const
+
+export type ExclusiveActionState = (typeof EXCLUSIVE_ACTION_STATES)[number]
+
+export type ExclusiveActionInput = {
+  scope: string
+  part: string
+  /** Active snapshot token, usually `stateToAttr(snapshot.value)`. */
+  state: string
+  busy: boolean
+  error: string | null
+  className?: string
+  tag?: 'form' | 'div'
+  /** Panel-specific fields. A host, so the tree stays generic. */
+  body: Widget
+  idleLabel: string
+  pendingLabel: string
+  primaryClassName?: string
+  primaryDisabled?: boolean
+  onSubmit?: (event: { preventDefault(): void }) => void
+  secondary?: {
+    label: string
+    className?: string
+    disabled?: boolean
+    onClick: () => void
+  }
+  actionsClassName?: string
+  /** When set, the `confirm` host is mounted. The app renders its Prompt there. */
+  confirm?: boolean
+}
+
+/**
+ * One widget for an exclusive mutation. The root carries the chart state;
+ * the primary label and the disabled set are functions of `busy`, and the
+ * failure copy is a child that exists only when `error` is set.
+ */
+export function exclusiveActionWidget(input: ExclusiveActionInput): Widget {
+  const children: Widget[] = [input.body]
+
+  if (input.error) {
+    children.push({
+      type: 'el',
+      tag: 'p',
+      part: 'error',
+      className: 'error',
+      role: 'alert',
+      children: [text(input.error)],
+    })
+  }
+
+  const actions: Widget[] = [
+    {
+      type: 'el',
+      tag: 'button',
+      part: 'primary',
+      buttonType: input.tag === 'div' ? 'button' : 'submit',
+      disabled: input.busy || input.primaryDisabled,
+      className: input.primaryClassName,
+      onClick: input.tag === 'div' ? () => input.onSubmit?.({ preventDefault() {} }) : undefined,
+      children: [text(input.busy ? input.pendingLabel : input.idleLabel)],
+    },
+  ]
+
+  if (input.secondary) {
+    actions.push({
+      type: 'el',
+      tag: 'button',
+      part: 'secondary',
+      buttonType: 'button',
+      disabled: input.busy || input.secondary.disabled,
+      className: input.secondary.className,
+      onClick: input.secondary.onClick,
+      children: [text(input.secondary.label)],
+    })
+  }
+
+  children.push({
+    type: 'el',
+    tag: 'div',
+    part: 'actions',
+    className: input.actionsClassName,
+    state: input.state,
+    children: actions,
+  })
+
+  if (input.confirm) children.push(host('confirm'))
+
+  return {
+    type: 'el',
+    tag: input.tag ?? 'form',
+    scope: input.scope,
+    part: input.part,
+    state: input.state,
+    className: input.className,
+    onSubmit: input.tag === 'div' ? undefined : input.onSubmit,
+    children,
+  }
+}

package/packages/tree/src/index.ts

@@ -0,0 +1,7 @@
+export { exclusiveActionWidget, EXCLUSIVE_ACTION_STATES } from './exclusive-action.js'
+export type { ExclusiveActionInput, ExclusiveActionState } from './exclusive-action.js'
+export { interpret } from './interpret.js'
+export type { WidgetHosts } from './interpret.js'
+export { uncoveredStates, widgetStates } from './totality.js'
+export { host, text } from './widget.js'
+export type { Widget } from './widget.js'