@mmapp/react 0.1.0-alpha.1 → 0.1.0-alpha.3

package/src/types/workflow-inference.ts

@@ -1,158 +0,0 @@
-/**
- * Type inference utilities for workflow model definitions.
- *
- * These mapped types extract TypeScript types from defineModel() results,
- * enabling typed hooks (useModel, useQuery, useMutation) to provide
- * IntelliSense on field names, state names, and transition names.
- *
- * @example
- * ```typescript
- * import auth from '../models/authentication';
- * type Fields = InferFields<typeof auth>;
- * // { appName: string; layout: string; showSignup: boolean; ... }
- *
- * type Trans = InferTransitions<typeof auth>;
- * // 'login' | 'signup' | 'logout' | 'retry' | ...
- *
- * type States = InferStates<typeof auth>;
- * // 'unauthenticated' | 'authenticating' | 'authenticated' | 'error'
- * ```
- */
-
-// =============================================================================
-// Field Type Mapping
-// =============================================================================
-
-/**
- * Maps WorkflowFieldDescriptor.type strings to TypeScript types.
- * Covers all built-in field types in the MindMatrix type system.
- */
-export type FieldTypeMap = {
-  // Text types
-  string: string;
-  text: string;
-  rich_text: string;
-  email: string;
-  url: string;
-  phone: string;
-  color: string;
-  select: string;
-
-  // Numeric types
-  number: number;
-  integer: number;
-  float: number;
-  currency: number;
-  percentage: number;
-  rating: number;
-  duration: number;
-  auto_number: number;
-
-  // Boolean
-  boolean: boolean;
-
-  // Date/Time
-  date: string;
-  datetime: string;
-  time: string;
-  created_at: string;
-  updated_at: string;
-
-  // Complex types
-  array: unknown[];
-  object: Record<string, unknown>;
-  json: unknown;
-  file: string;
-  image: string;
-
-  // Relation types
-  relation: string;
-  multi_relation: string[];
-  lookup: unknown;
-  rollup: unknown;
-};
-
-// =============================================================================
-// Inference Types
-// =============================================================================
-
-/**
- * Infer the TypeScript shape of a model's fields.
- *
- * Given a model definition D (from defineModel()), produces an object type
- * where each key is a field name and each value is the corresponding TS type.
- *
- * @example
- * ```typescript
- * const model = defineModel({
- *   slug: 'test',
- *   fields: {
- *     name: { type: 'string', required: true },
- *     count: { type: 'number', default: 0 },
- *     active: { type: 'boolean', default: true },
- *   },
- *   states: {}, transitions: {},
- * });
- * type F = InferFields<typeof model>;
- * // { name: string; count: number; active: boolean }
- * ```
- */
-export type InferFields<D> = D extends { fields: infer F extends Record<string, { type: string }> }
-  ? {
-      [K in keyof F]: F[K] extends { type: infer T extends string }
-        ? T extends keyof FieldTypeMap
-          ? FieldTypeMap[T]
-          : unknown
-        : unknown;
-    }
-  : Record<string, unknown>;
-
-/**
- * Infer a union of transition names from a model definition.
- *
- * @example
- * ```typescript
- * type T = InferTransitions<typeof authModel>;
- * // 'login' | 'signup' | 'logout' | 'retry'
- * ```
- */
-export type InferTransitions<D> = D extends { transitions: infer T }
-  ? Extract<keyof T, string>
-  : string;
-
-/**
- * Infer a union of state names from a model definition.
- *
- * @example
- * ```typescript
- * type S = InferStates<typeof authModel>;
- * // 'unauthenticated' | 'authenticating' | 'authenticated' | 'error'
- * ```
- */
-export type InferStates<D> = D extends { states: infer S }
-  ? Extract<keyof S, string>
-  : string;
-
-/**
- * Extract the slug literal type from a model definition.
- *
- * @example
- * ```typescript
- * type Slug = InferSlug<typeof authModel>;
- * // 'mod-authentication'
- * ```
- */
-export type InferSlug<D> = D extends { slug: infer S extends string } ? S : string;
-
-/**
- * Infer a union of field names from a model definition.
- *
- * @example
- * ```typescript
- * type FN = InferFieldNames<typeof authModel>;
- * // 'appName' | 'layout' | 'showSignup' | ...
- * ```
- */
-export type InferFieldNames<D> = D extends { fields: infer F }
-  ? Extract<keyof F, string>
-  : string;

package/src/types.ts

@@ -1,114 +0,0 @@
-/**
- * Player Web Types — React integration types for the browser-side workflow engine.
- */
-
-import type {
-  PlayerWorkflowDefinition,
-  TransitionResult,
-  StateMachineEvent,
-  ActionHandlerFn,
-  BusEvent,
-  EventBus,
-} from '@mindmatrix/player-core';
-
-/** Configuration for creating a Player instance */
-export interface PlayerConfig {
-  /** Workflow definition to interpret */
-  definition: PlayerWorkflowDefinition;
-  /** Initial state_data */
-  initialData?: Record<string, unknown>;
-  /** Custom action handlers to register */
-  actionHandlers?: Record<string, ActionHandlerFn>;
-  /** Custom expression functions */
-  functions?: Array<{ name: string; fn: (...args: unknown[]) => unknown; arity: number }>;
-  /** Enable structured logging */
-  debug?: boolean;
-}
-
-/** Player instance exposed to React components */
-export interface PlayerHandle {
-  /** Current state name */
-  currentState: string;
-  /** Current state_data */
-  stateData: Record<string, unknown>;
-  /** Current instance status */
-  status: 'ACTIVE' | 'COMPLETED' | 'CANCELLED';
-  /** Execute a named transition */
-  transition: (name: string, data?: Record<string, unknown>) => Promise<TransitionResult>;
-  /** Set a field in state_data */
-  setField: (field: string, value: unknown) => void;
-  /** Set a memory value */
-  setMemory: (key: string, value: unknown) => void;
-  /** Get available (non-auto) transitions from current state */
-  availableTransitions: string[];
-  /** Publish an event to the local event bus */
-  publishEvent: (topic: string, payload?: Record<string, unknown>) => void;
-  /** The underlying event bus instance (for domain subscription wiring) */
-  eventBus: EventBus;
-}
-
-/** Domain event received from WebSocket */
-export interface DomainEvent {
-  instance_id: string;
-  definition_id?: string;
-  definition_slug?: string;
-  from_state: string;
-  to_state: string;
-  transition_name: string;
-  trigger?: 'user' | 'auto' | 'resume' | 'system';
-  state_data_before?: Record<string, unknown>;
-  state_data_after?: Record<string, unknown>;
-  changed_fields?: string[];
-  entity_type?: string | null;
-  entity_id?: string | null;
-  blocked?: boolean;
-}
-
-/** Subscription configuration for domain events */
-export interface DomainSubscriptionConfig {
-  /** Instance IDs to subscribe to */
-  instanceIds?: string[];
-  /** Entity scope for room subscription */
-  entity?: { type: string; id: string };
-  /** Event patterns to match (glob-style) */
-  patterns?: string[];
-  /** Callback when an event matches */
-  onEvent?: (event: BusEvent) => void;
-  /** Enable/disable subscription */
-  enabled?: boolean;
-}
-
-/** Experience workflow definition — extends player-core definition with view metadata */
-export interface ExperienceWorkflowDefinition extends PlayerWorkflowDefinition {
-  /** Experience tree to render in each state */
-  state_views?: Record<string, ExperienceViewConfig>;
-  /** Global experience configuration */
-  experience?: {
-    /** Default layout for states without explicit views */
-    default_layout?: 'stack' | 'row' | 'grid' | 'tabs';
-    /** Theme/branding config */
-    theme?: Record<string, unknown>;
-  };
-}
-
-/** View configuration for a specific state */
-export interface ExperienceViewConfig {
-  /** Experience tree (ExperienceNode) to render */
-  tree?: Record<string, unknown>;
-  /** Experience ID to load from registry */
-  experienceId?: string;
-  /** Title for the state's view */
-  title?: string;
-}
-
-/** Logging context for structured warnings */
-export interface PlayerLogEntry {
-  level: 'debug' | 'info' | 'warn' | 'error';
-  category: 'event_match' | 'action_dispatch' | 'expression' | 'transition' | 'lifecycle';
-  message: string;
-  data?: Record<string, unknown>;
-  timestamp: number;
-}
-
-/** Player event listener for React components */
-export type PlayerEventListener = (event: StateMachineEvent) => void;

package/tsconfig.json

@@ -1,27 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "lib": ["ES2022", "DOM"],
-    "jsx": "react-jsx",
-    "moduleResolution": "node",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "noImplicitAny": true,
-    "strictNullChecks": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "**/__tests__", "**/*.test.ts", "**/*.test.tsx", "**/*.spec.ts"]
-}

package/vitest.config.ts

@@ -1,8 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-  },
-});