@farmslot/adapter-rn 0.15.0

package/templates/src/farmslot/RecipeBridgeProvider.tsx

@@ -0,0 +1,127 @@
+import React, { createContext, useEffect, useMemo, useState } from 'react';
+import { Platform, View } from 'react-native';
+
+import { type FarmslotRecipeHudState, RecipeHud, type RecipeHudOptions } from './RecipeHud';
+
+export interface FarmslotRecipeBridgeCommand {
+  command: string;
+  nodeId: string;
+  payload?: Record<string, unknown>;
+}
+
+export interface FarmslotRecipeBridgeApi {
+  handleCommand(command: FarmslotRecipeBridgeCommand): Promise<unknown>;
+}
+
+export interface RecipeBridgeProviderOptions {
+  bridgeName?: string;
+  hud?: RecipeHudOptions;
+  isEnabled?: () => boolean;
+  renderHud?: (state: FarmslotRecipeHudState | null) => React.ReactNode;
+}
+
+declare global {
+  var __FARMSLOT_RECIPE_BRIDGE__: FarmslotRecipeBridgeApi | undefined;
+}
+
+export const FarmslotRecipeBridgeContext = createContext<FarmslotRecipeBridgeApi | null>(null);
+
+interface RecipeBridgeProviderProps extends RecipeBridgeProviderOptions {
+  children: React.ReactNode;
+}
+
+export function RecipeBridgeProvider({
+  bridgeName = '@farmslot/adapter-rn',
+  children,
+  hud: hudOptions,
+  isEnabled = isRecipeBridgeEnabled,
+  renderHud,
+}: Readonly<RecipeBridgeProviderProps>): React.ReactElement {
+  const enabled = isEnabled();
+  const [hud, setHud] = useState<FarmslotRecipeHudState | null>(null);
+
+  const bridge = useMemo<FarmslotRecipeBridgeApi>(
+    () => ({
+      async handleCommand(command) {
+        if (!enabled) {
+          return { ok: false, error: 'Farmslot recipe bridge is disabled.' };
+        }
+        if (command.command === 'status') {
+          return { ok: true, bridge: bridgeName, platform: Platform.OS, hud: true };
+        }
+        if (command.command === 'hud') {
+          setHud(normalizeHudState(command.payload));
+          return { ok: true };
+        }
+        if (command.command === 'trace') {
+          return { ok: true, trace: command.payload ?? {} };
+        }
+        return { ok: false, error: `Unsupported Farmslot bridge command: ${command.command}` };
+      },
+    }),
+    [bridgeName, enabled],
+  );
+
+  useEffect(() => {
+    if (!enabled) return;
+    globalThis.__FARMSLOT_RECIPE_BRIDGE__ = bridge;
+    return () => {
+      if (globalThis.__FARMSLOT_RECIPE_BRIDGE__ === bridge) {
+        globalThis.__FARMSLOT_RECIPE_BRIDGE__ = undefined;
+      }
+    };
+  }, [bridge, enabled]);
+
+  if (!enabled) return <>{children}</>;
+
+  return (
+    <FarmslotRecipeBridgeContext.Provider value={bridge}>
+      <View style={{ flex: 1 }}>
+        {children}
+        {renderHud ? renderHud(hud) : <RecipeHud state={hud} {...hudOptions} />}
+      </View>
+    </FarmslotRecipeBridgeContext.Provider>
+  );
+}
+
+function isRecipeBridgeEnabled(): boolean {
+  return Boolean(__DEV__ && process.env.EXPO_PUBLIC_FARMSLOT_RECIPE_BRIDGE === '1');
+}
+
+function normalizeHudState(payload: Record<string, unknown> | undefined): FarmslotRecipeHudState {
+  const status = parseStatus(payload?.status);
+  const progress = isRecord(payload?.progress) ? payload.progress : undefined;
+  return {
+    status,
+    intent: asString(
+      payload?.intent ?? payload?.text,
+      status === 'fail' ? 'Recipe failed' : 'Recipe HUD missing intent',
+    ),
+    currentStep: asOptionalNumber(
+      payload?.currentStep ?? payload?.current_step ?? progress?.current,
+    ),
+    totalSteps: asOptionalNumber(payload?.totalSteps ?? payload?.total_steps ?? progress?.total),
+    error: asOptionalString(payload?.error),
+  };
+}
+
+function parseStatus(value: unknown): FarmslotRecipeHudState['status'] {
+  if (value === 'idle' || value === 'running' || value === 'pass' || value === 'fail') return value;
+  return 'running';
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+
+function asString(value: unknown, fallback: string): string {
+  return typeof value === 'string' && value.trim() ? value : fallback;
+}
+
+function asOptionalString(value: unknown): string | undefined {
+  return typeof value === 'string' && value.trim() ? value : undefined;
+}
+
+function asOptionalNumber(value: unknown): number | undefined {
+  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}

package/templates/src/farmslot/RecipeHud.tsx

@@ -0,0 +1,138 @@
+import React from 'react';
+import {
+  type StyleProp,
+  StyleSheet,
+  Text,
+  type TextStyle,
+  View,
+  type ViewStyle,
+} from 'react-native';
+
+export type FarmslotRecipeHudStatus = 'idle' | 'running' | 'pass' | 'fail';
+
+export interface FarmslotRecipeHudState {
+  status: FarmslotRecipeHudStatus;
+  intent: string;
+  currentStep?: number;
+  totalSteps?: number;
+  error?: string;
+}
+
+export interface FarmslotRecipeHudText {
+  badge?: (state: FarmslotRecipeHudState) => string;
+  intent?: (state: FarmslotRecipeHudState) => string;
+  error?: (state: FarmslotRecipeHudState) => string | undefined;
+}
+
+export interface FarmslotRecipeHudStyles {
+  container?: StyleProp<ViewStyle>;
+  line?: StyleProp<TextStyle>;
+  badgeText?: StyleProp<TextStyle>;
+  badgeTextRunning?: StyleProp<TextStyle>;
+  badgeTextPass?: StyleProp<TextStyle>;
+  badgeTextFail?: StyleProp<TextStyle>;
+  intent?: StyleProp<TextStyle>;
+  error?: StyleProp<TextStyle>;
+}
+
+export interface RecipeHudOptions {
+  text?: FarmslotRecipeHudText;
+  styles?: FarmslotRecipeHudStyles;
+}
+
+export interface RecipeHudProps extends RecipeHudOptions {
+  state: FarmslotRecipeHudState | null;
+}
+
+export function RecipeHud({
+  state,
+  styles: customStyles,
+  text,
+}: Readonly<RecipeHudProps>): React.ReactElement | null {
+  if (!state || state.status === 'idle') return null;
+  const badge = text?.badge?.(state) ?? formatBadge(state);
+  const intent = text?.intent?.(state) ?? state.intent;
+  const error = text?.error?.(state) ?? state.error;
+  const badgeTone = badgeToneForStatus(state.status);
+  return (
+    <View pointerEvents="none" style={[styles.container, customStyles?.container]}>
+      <Text style={[styles.line, customStyles?.line]}>
+        <Text
+          style={[
+            styles.badgeText,
+            badgeTone === 'fail'
+              ? styles.badgeTextFail
+              : badgeTone === 'pass'
+                ? styles.badgeTextPass
+                : styles.badgeTextRunning,
+            customStyles?.badgeText,
+            badgeTone === 'fail'
+              ? customStyles?.badgeTextFail
+              : badgeTone === 'pass'
+                ? customStyles?.badgeTextPass
+                : customStyles?.badgeTextRunning,
+          ]}
+        >
+          {badge}
+        </Text>
+        {intent ? <Text style={customStyles?.intent}>{`  ${intent}`}</Text> : null}
+      </Text>
+      {error ? <Text style={[styles.error, customStyles?.error]}>{error}</Text> : null}
+    </View>
+  );
+}
+
+function formatBadge(state: FarmslotRecipeHudState): string {
+  const status = state.status === 'running' ? 'run' : state.status;
+  const progress = formatProgress(state.currentStep, state.totalSteps);
+  return [status, progress].filter(Boolean).join(' ').toUpperCase();
+}
+
+function formatProgress(currentStep?: number, totalSteps?: number): string {
+  if (!currentStep || !totalSteps) return '';
+  return `${currentStep}/${totalSteps}`;
+}
+
+function badgeToneForStatus(status: FarmslotRecipeHudStatus): 'running' | 'pass' | 'fail' {
+  if (status === 'fail') return 'fail';
+  if (status === 'pass') return 'pass';
+  return 'running';
+}
+
+const styles = StyleSheet.create({
+  container: {
+    position: 'absolute',
+    left: 0,
+    right: 0,
+    bottom: 0,
+    zIndex: 9999,
+    backgroundColor: 'rgba(0, 0, 0, 0.58)',
+    paddingHorizontal: 10,
+    paddingVertical: 3,
+  },
+  line: {
+    color: '#ffffff',
+    fontSize: 11,
+    fontWeight: '700',
+    lineHeight: 14,
+  },
+  badgeText: {
+    fontSize: 9,
+    fontWeight: '800',
+  },
+  badgeTextRunning: {
+    color: '#00ff88',
+  },
+  badgeTextPass: {
+    color: '#00ff88',
+  },
+  badgeTextFail: {
+    color: '#ff4d4f',
+  },
+  error: {
+    color: '#e6e6e6',
+    fontSize: 10,
+    fontWeight: '400',
+    lineHeight: 12,
+  },
+});

package/templates/src/farmslot/index.ts

@@ -0,0 +1,11 @@
+export type { FarmslotRecipeBridgeApi, FarmslotRecipeBridgeCommand } from './RecipeBridgeProvider';
+export { FarmslotRecipeBridgeContext, RecipeBridgeProvider } from './RecipeBridgeProvider';
+export type {
+  FarmslotRecipeHudState,
+  FarmslotRecipeHudStatus,
+  FarmslotRecipeHudStyles,
+  FarmslotRecipeHudText,
+  RecipeHudOptions,
+  RecipeHudProps,
+} from './RecipeHud';
+export { RecipeHud } from './RecipeHud';