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

package/src/__tests__/typed-transitions.test.ts

@@ -1,126 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { model, field, state, transition, TypedTransitionBuilder } from '../builders';
-import { setField, logEvent } from '../actions';
-
-describe('TypedTransitionBuilder — type-safe state references', () => {
-  it('accepts a callback that builds a typed transition', () => {
-    const result = model('invoice')
-      .state('draft', state.initial())
-      .state('sent')
-      .state('paid', state.end())
-      .transition('send', t => t.from('draft').to('sent'))
-      .build();
-
-    expect(result.transitions.send.from).toBe('draft');
-    expect(result.transitions.send.to).toBe('sent');
-  });
-
-  it('supports require, roles, and when in callback form', () => {
-    const result = model('invoice')
-      .state('draft', state.initial())
-      .state('review')
-      .state('approved', state.end())
-      .transition('submit', t =>
-        t.from('draft').to('review').require('amount', 'title')
-      )
-      .transition('approve', t =>
-        t.from('review').to('approved').roles('manager').when('state_data.amount < 10000')
-      )
-      .build();
-
-    expect(result.transitions.submit.requiredFields).toEqual(['amount', 'title']);
-    expect(result.transitions.approve.roles).toEqual(['manager']);
-    expect(result.transitions.approve.conditions).toHaveLength(1);
-  });
-
-  it('supports auto transitions in callback form', () => {
-    const result = model('pipeline')
-      .state('processing', state.initial())
-      .state('done', state.end())
-      .transition('complete', t =>
-        t.from('processing').to('done').auto()
-      )
-      .build();
-
-    expect(result.transitions.complete.auto).toBe(true);
-  });
-
-  it('supports multiple from states in callback form', () => {
-    const result = model('order')
-      .state('placed', state.initial())
-      .state('confirmed')
-      .state('cancelled', state.end())
-      .transition('cancel', t => t.from('placed', 'confirmed').to('cancelled'))
-      .build();
-
-    expect(result.transitions.cancel.from).toEqual(['placed', 'confirmed']);
-    expect(result.transitions.cancel.to).toBe('cancelled');
-  });
-
-  it('coexists with untyped transition() calls', () => {
-    const result = model('test')
-      .state('a', state.initial())
-      .state('b')
-      .state('c', state.end())
-      // typed callback
-      .transition('ab', t => t.from('a').to('b'))
-      // untyped existing API
-      .transition('bc', transition.from('b').to('c'))
-      .build();
-
-    expect(result.transitions.ab).toEqual({ from: 'a', to: 'b' });
-    expect(result.transitions.bc).toEqual({ from: 'b', to: 'c' });
-  });
-
-  it('coexists with plain object descriptors', () => {
-    const result = model('test')
-      .state('x', state.initial())
-      .state('y', state.end())
-      .transition('go', { from: 'x', to: 'y' })
-      .build();
-
-    expect(result.transitions.go.from).toBe('x');
-    expect(result.transitions.go.to).toBe('y');
-  });
-
-  it('supports description in callback form', () => {
-    const result = model('test')
-      .state('a', state.initial())
-      .state('b', state.end())
-      .transition('go', t => t.from('a').to('b').description('Move from a to b'))
-      .build();
-
-    expect(result.transitions.go.description).toBe('Move from a to b');
-  });
-
-  it('supports do() with actions in callback form', () => {
-    const result = model('test')
-      .state('a', state.initial())
-      .state('b', state.end())
-      .transition('go', t =>
-        t.from('a').to('b').do(setField('status', '"done"'), logEvent('completed'))
-      )
-      .build();
-
-    expect(result.transitions.go.actions).toHaveLength(2);
-    expect(result.transitions.go.actions![0].type).toBe('set_field');
-    expect(result.transitions.go.actions![1].type).toBe('log_event');
-  });
-});
-
-describe('TypedTransitionBuilder class standalone', () => {
-  it('builds a valid TransitionDescriptor', () => {
-    const builder = new TypedTransitionBuilder<'a' | 'b'>();
-    builder.from('a').to('b').require('name');
-    const desc = builder.build();
-
-    expect(desc.from).toBe('a');
-    expect(desc.to).toBe('b');
-    expect(desc.requiredFields).toEqual(['name']);
-  });
-
-  it('throws when from/to are missing', () => {
-    const builder = new TypedTransitionBuilder<'a'>();
-    expect(() => builder.build()).toThrow('from() is required');
-  });
-});

package/src/__tests__/useModuleConfig.test.ts

@@ -1,61 +0,0 @@
-/**
- * Tests for useModuleConfig — config merging and module lookup.
- */
-
-import { describe, it, expect, beforeEach } from 'vitest';
-import {
-  setInstalledModules,
-  setModuleConfigDefaults,
-  getInstalledModule,
-  getInstalledModules,
-  type InstalledModuleRef,
-} from '../hooks/useModuleConfig';
-
-describe('useModuleConfig store', () => {
-  beforeEach(() => {
-    setInstalledModules([]);
-  });
-
-  it('stores and retrieves installed modules', () => {
-    const modules: InstalledModuleRef[] = [
-      { slug: 'mod-auth', moduleId: 'auth-001', config: { layout: 'card' } },
-      { slug: 'mod-notif', moduleId: 'notif-001' },
-    ];
-
-    setInstalledModules(modules);
-
-    expect(getInstalledModules()).toHaveLength(2);
-    expect(getInstalledModule('mod-auth')?.config?.layout).toBe('card');
-    expect(getInstalledModule('mod-notif')).toBeDefined();
-    expect(getInstalledModule('mod-unknown')).toBeUndefined();
-  });
-
-  it('stores routeConfig and slotMapping on installed module', () => {
-    setInstalledModules([{
-      slug: 'mod-auth',
-      moduleId: 'auth-001',
-      routeConfig: { prefix: '/auth', routes: { '/login': '/' } },
-      slotMapping: { 'auth:profile': 'app:settings' },
-    }]);
-
-    const mod = getInstalledModule('mod-auth');
-    expect(mod?.routeConfig?.prefix).toBe('/auth');
-    expect(mod?.routeConfig?.routes?.['/login']).toBe('/');
-    expect(mod?.slotMapping?.['auth:profile']).toBe('app:settings');
-  });
-
-  it('setModuleConfigDefaults works', () => {
-    setModuleConfigDefaults('mod-auth', { layout: 'split', methods: ['email'] });
-
-    // Config defaults are stored and can be merged with install-time config
-    // (useModuleConfig hook merges them, but we test the store directly here)
-    setInstalledModules([{
-      slug: 'mod-auth',
-      moduleId: 'auth-001',
-      config: { layout: 'card' },
-    }]);
-
-    const mod = getInstalledModule('mod-auth');
-    expect(mod?.config?.layout).toBe('card'); // install-time wins
-  });
-});

package/src/actionCreators.ts

@@ -1,132 +0,0 @@
-/**
- * @mindmatrix/react/actionCreators — Type-safe action reference factories.
- *
- * Replaces stringly-typed `serverAction("authenticate", {...})` calls with
- * typed action creators that catch typos at compile time.
- *
- * @example
- * ```typescript
- * import { createActions } from '@mindmatrix/react';
- *
- * const actions = createActions({
- *   authenticate: { handler: 'actions/auth.server.ts' },
- *   destroySession: { handler: 'actions/auth.server.ts' },
- *   resetPassword: { handler: 'actions/auth.server.ts' },
- * });
- *
- * // Usage in models — fully typed, autocomplete on action names:
- * .do(actions.authenticate({ method: 'login' }))
- * .do(actions.destroySession())
- *
- * // Typo = TypeScript compile error:
- * .do(actions.autenticate({}))
- * //         ~~~~~~~~~~~~ Property 'autenticate' does not exist
- * ```
- *
- * @module
- */
-
-import type { ActionDefinition } from './config/defineModel';
-
-// =============================================================================
-// Action Manifest & Creators
-// =============================================================================
-
-/**
- * Configuration for a single action in the manifest.
- */
-export interface ActionManifestEntry {
-  /** The handler file path (e.g., 'actions/auth.server.ts'). */
-  handler: string;
-  /** Optional function name within the handler file. */
-  functionName?: string;
-  /** Optional description for documentation. */
-  description?: string;
-  /** Action execution mode. Default: 'auto'. */
-  mode?: 'auto' | 'manual';
-}
-
-/**
- * A manifest mapping action names to their configuration.
- */
-export type ActionManifest = Record<string, ActionManifestEntry>;
-
-/**
- * A typed action creator function returned for each manifest entry.
- * Accepts optional config and returns an ActionDefinition.
- */
-export type ActionCreator = (config?: Record<string, unknown>) => ActionDefinition;
-
-/**
- * Maps an ActionManifest to an object of typed action creators.
- * Each key from the manifest becomes a callable action creator.
- */
-export type ActionCreators<M extends ActionManifest> = {
-  readonly [K in keyof M]: ActionCreator;
-};
-
-/**
- * Convert a camelCase or PascalCase string to kebab-case.
- * @internal
- */
-function toKebab(str: string): string {
-  return str
-    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
-    .replace(/[_.:\s]+/g, '-')
-    .toLowerCase();
-}
-
-/**
- * Create typed action creators from an actions manifest.
- *
- * Each key in the manifest becomes a function that returns an {@link ActionDefinition}
- * compatible with `.do()`, `onEnter`, `onExit`, and other action slots.
- *
- * The action type is `server:{kebab-case-name}` and the handler path is stored
- * in the config for the build pipeline to resolve.
- *
- * @param manifest - Object mapping action names to their configuration.
- * @returns An object with the same keys, where each value is a typed action creator.
- *
- * @example
- * ```typescript
- * const actions = createActions({
- *   authenticate: { handler: 'actions/auth.server.ts' },
- *   destroySession: { handler: 'actions/auth.server.ts' },
- *   sendWelcomeEmail: { handler: 'actions/email.server.ts', mode: 'manual' },
- * });
- *
- * // Returns ActionDefinition:
- * actions.authenticate({ method: 'login' })
- * // => { id: 'server-authenticate', type: 'server:authenticate',
- * //      mode: 'auto', config: { method: 'login', __handler: 'actions/auth.server.ts' } }
- *
- * actions.destroySession()
- * // => { id: 'server-destroy-session', type: 'server:destroySession',
- * //      mode: 'auto', config: { __handler: 'actions/auth.server.ts' } }
- * ```
- */
-export function createActions<const M extends ActionManifest>(manifest: M): ActionCreators<M> {
-  const creators = {} as Record<string, ActionCreator>;
-
-  for (const [name, entry] of Object.entries(manifest)) {
-    creators[name] = (config?: Record<string, unknown>): ActionDefinition => {
-      const actionConfig: Record<string, unknown> = {
-        ...config,
-        __handler: entry.handler,
-      };
-      if (entry.functionName) {
-        actionConfig.__functionName = entry.functionName;
-      }
-      return {
-        id: `server-${toKebab(name)}`,
-        type: `server:${name}`,
-        mode: entry.mode ?? 'auto',
-        config: actionConfig,
-      };
-    };
-  }
-
-  return creators as ActionCreators<M>;
-}
-