jssm 5.45.2 → 5.46.0

package/src/ts/tests/state_declaration.spec.ts

@@ -1,214 +0,0 @@
-
-/* eslint-disable max-len */
-
-import * as jssm from '../jssm';
-
-const sm = jssm.sm;
-
-
-
-
-
-describe("doesn't throw", () => {
-
-  test('with no attributes', () =>
-    expect(() => { const _foo = sm`state c: {}; a -> b;`; })
-      .not.toThrow() );
-
-  test('with just whitespace', () =>
-    expect(() => { const _foo = sm`state c: { }; a -> b;`; })
-      .not.toThrow() );
-
-  test('with just node color', () =>
-    expect(() => { const _foo = sm`state c: { color: red; }; a -> b;`; })
-      .not.toThrow() );
-
-});
-
-
-
-
-
-describe('can read declaration', () => {
-
-  const mach0 = sm`state c: { }; a -> b;`,
-        mach1 = sm`state c: { color: red; }; a -> b;`,
-        mach2 = sm`state c: { color: red; shape: circle; }; a -> b;`;
-
-  test.todo('Incomplete test prototypes in state_declaration');
-
-  // const machT = sm`c: { color: red; }; d: { shape: circle; }; a -> b;`;
-
-  // const machP = sm`
-  //   c: { shape: circle; color: red; };
-  //   d: { shape: circle; color: red; };
-  //   a -> b;
-  // `;
-
-
-  describe('of w/ nothing', () => {
-    const decls = mach0.state_declarations();
-    describe('through .state_declarations/0 w nothing', () => {
-
-      test('yielding map', () =>
-        expect( decls instanceof Map ).toBe(true) );
-
-      test('list having size 1', () =>
-        expect( decls.size ).toBe(1) );
-
-      test('props having length 0', () =>
-        expect( decls.get('c').declarations.length ).toBe(0) );
-
-    });
-  });
-
-
-  describe('of just w/ color', () => {
-    const decls = mach1.state_declarations();
-    describe('through .state_declarations/0 just state color', () => {
-
-      test('yielding map', () =>
-        expect(decls instanceof Map ).toBe(true) );
-
-      test('list having size 1', () =>
-        expect(decls.size).toBe(1) );
-
-      test('props having length 1', () =>
-        expect(decls.get('c').declarations.length ).toBe(1) );
-
-      // todo whargarbl check the actual members comeback
-    });
-
-    test('through .state_declaration/1',  () =>
-      expect(mach1.state_declaration('c').declarations[0].value )
-        .toBe('#ff0000ff') );
-
-  });
-
-
-  describe('of w/ color, shape', () => {
-
-    test('through .state_declaration/1 red hex-8', () =>
-      expect(mach2.state_declaration('c').declarations[0].value )
-        .toBe('#ff0000ff') );
-
-    test('through .state_declaration/1 circle', () =>
-      expect(mach2.state_declaration('c').declarations[1].value )
-        .toBe('circle') );
-
-    test('through .state_declarations/0 size', () =>
-      expect(mach2.state_declarations().size )
-        .toBe(1) );
-
-    test.todo('Re-enable once state_declarations/0 exposes type 3');
-
-    test('through .state_declarations/0 declarations length', () =>
-      expect(mach2.state_declarations().get('c').declarations.length )
-        .toBe(2) );
-
-  });
-
-test.todo('Not sure why these were commented out tbh');
-
-/*
-  describe('of w/ color on c, shape on d', () => {
-
-    test('through .state_declaration/1', () =>
-      expect(machT.state_declaration('c') )
-        .toBe('left') );
-
-    test('through .state_declaration/1', () =>
-      expect(machT.state_declaration('d') )
-        .toBe('left') );
-
-    test('through .state_declarations/0', () =>
-      expect(machT.state_declarations() )
-        .toBe('left') );
-
-  });
-
-
-  describe('of w/ color, shape on each c and d', () => {
-
-    test('through .state_declaration/1', () =>
-      expect(machP.state_declaration('c') )
-        .toBe('left') );
-
-    test('through .state_declaration/1', () =>
-      expect(machP.state_declaration('d') )
-        .toBe('left') );
-
-    test('through .state_declarations/0', () =>
-      expect(machP.state_declarations() )
-        .toBe('left') );
-
-  });
-*/
-});
-
-
-
-
-
-describe('error catchery', () => {
-
-  test('repeated declaration throws', () =>
-    expect( () => { const _mach1 = sm`state c: { color: red; }; state c: { color: red; }; a -> b;`; } )  // eslint-disable-line no-unused-vars
-      .toThrow()
-  );
-
-
-  describe('unknown state property', () => {
-
-    const prestate = {
-      "start_states":["b"],
-      "transitions":[{"from":"b","to":"c","kind":"legal","forced_only":false,"main_path":false}],
-      "state_declaration":[{"state":"a","declarations":[{"key":"urgle bergle","value":"circle"}]}]};
-
-    test('throws', () =>
-      expect( () => { const _m0 = new jssm.Machine(prestate as any); } )
-        .toThrow() );
-
-  });
-
-
-  test('transfer state properties throws on unknown key', () =>
-    expect( () => { jssm.transfer_state_properties({declarations: [{key: 'agsrhdtjfy', value: 'seven'}]} as any); } )
-      .toThrow()
-  );
-
-  test('Cannot declare the same state twice', () =>
-    expect( () => { const mach0 = sm`state c: { }; state c: { }; a -> b;`; } )
-      .toThrow()
-  );
-
-  test('Cannot generate an existing state', () =>
-    expect( () => {
-      const errM = sm`a->c;state c:{};`;
-      const errR = errM._new_state({name:'c'} as any);
-    } )
-      .toThrow()
-  );
-
-  test('Cannot generate an empty state name as string', () =>
-    expect( () => {
-      const errM = sm`state "":{};`;
-    } )
-      .toThrow()
-  );
-
-  describe('Cannot generate an empty state name as datastructure', () => {
-
-    const prestate = {
-      "start_states":["b"],
-      "transitions":[{"from":"b","to":"c","kind":"legal","forced_only":false,"main_path":false}],
-      "state_declaration":[{"state":""}]
-    };
-
-    test('throws', () =>
-      expect( () => { const _m0 = new jssm.Machine(prestate as any); } )
-        .toThrow() );
-
-  });
-
-});

package/src/ts/tests/state_style.spec.ts

@@ -1,82 +0,0 @@
-
-import { Shapes, LineStyles } from './constants.spec';
-
-import { sm } from '../jssm';
-
-
-
-
-
-describe('State style', () => {
-
-
-
-  Shapes.map(shape => {
-
-    describe(shape, () => {
-
-      test(`can set regular state to ${shape}`, () =>
-        expect( () => {
-          const _foo = sm`machine_name: bob; state: { shape: ${shape}; }; a->b;`;
-        }).not.toThrow() );
-
-      test(`can set start state to ${shape}`, () =>
-        expect( () => {
-          const _foo = sm`machine_name: bob; start_state: { shape: ${shape}; }; a->b;`;
-        }).not.toThrow() );
-
-      test(`can set end state to ${shape}`, () =>
-        expect( () => {
-          const _foo = sm`machine_name: bob; end_state: { shape: ${shape}; }; a->b;`;
-        }).not.toThrow() );
-
-      test(`can set specific state to ${shape}`, () =>
-        expect( () => {
-          const _foo = sm`machine_name: bob; a->b; state a: { shape: ${shape}; };`;
-        }).not.toThrow() );
-
-    });
-
-  });
-
-
-
-  LineStyles.map(linestyle => {
-
-    // TODO FIXME it turns out state: , start_state: , and end_state: are on vestigial productions.  fix it
-
-    // test(`can set regular state border line style to ${linestyle}`, () =>
-    //   expect( () => {
-    //     const _foo = sm`machine_name: bob; state: { linestyle: ${linestyle}; }; a->b;`;
-    //   }).not.toThrow() );
-
-    // test(`can set start state border line style to ${linestyle}`, () =>
-    //   expect( () => {
-    //     const _foo = sm`machine_name: bob; start_state: { linestyle: ${linestyle}; }; a->b;`;
-    //   }).not.toThrow() );
-
-    // test(`can set end state border line style to ${linestyle}`, () =>
-    //   expect( () => {
-    //     const _foo = sm`machine_name: bob; end_state: { linestyle: ${linestyle}; }; a->b;`;
-    //   }).not.toThrow() );
-
-    test(`can set specific state border line style to ${linestyle}`, () =>
-      expect( () => {
-        const _foo = sm`machine_name: bob; a->b; state a: { linestyle: ${linestyle}; }; `;
-      }).not.toThrow() );
-
-    test(`can set transition line style to ${linestyle}`, () =>
-      expect( () => {
-        const _foo = sm`machine_name: bob; a{ linestyle: ${linestyle}; }->b;`;
-      }).not.toThrow() );
-
-
-  })
-
-
-
-});
-
-
-
-test.todo('Read the actual values back out');

package/src/ts/tests/stop light.spec.ts

@@ -1,157 +0,0 @@
-
-/* eslint-disable max-len */
-
-import * as jssm from '../jssm';
-
-
-
-
-
-describe('Simple stop light', () => {
-
-  const light = jssm.sm`Red 'Proceed' -> Green 'Proceed' -> Yellow 'Proceed' -> Red;`;
-
-  const r_states = light.states();
-
-  test('has the right state count', () =>
-    expect(r_states.length).toBe(3));
-
-  ['Red', 'Yellow', 'Green'].map(c =>
-    test(`has state "${c}"`, () =>
-      expect(r_states.includes(c)).toBe(true))
-  );
-
-  describe('- `proceed` walkthrough', () => {
-
-    test('machine starts red',  () => expect( light.state()           ).toBe( "Red"    ));
-    test('proceed is true',     () => expect( light.action('Proceed') ).toBe( true     ));
-    test('light is now green',  () => expect( light.state()           ).toBe( "Green"  ));
-    test('proceed is true 2',   () => expect( light.action('Proceed') ).toBe( true     ));
-    test('light is now yellow', () => expect( light.state()           ).toBe( "Yellow" ));
-    test('proceed is true 3',   () => expect( light.action('Proceed') ).toBe( true     ));
-    test('light is red again',  () => expect( light.state()           ).toBe( "Red"    ));
-
-  });
-
-  describe('- mixed - `proceed` and `transition`', () => {
-
-    test('machine starts red',              () => expect( light.state()              ).toBe("Red")    );
-    test('proceed is true',                 () => expect( light.action('Proceed')    ).toBe( true )   );
-    test('machine is now green',            () => expect( light.state()              ).toBe("Green")  );
-
-    test('refuses transition red',          () => expect( light.transition('Red')    ).toBe( false )  );
-    test('green still green',               () => expect( light.state()              ).toBe("Green")  );
-    test('refuses transition green',        () => expect( light.transition('Green')  ).toBe( false )  );
-    test('green still green',               () => expect( light.state()              ).toBe("Green")  );
-    test('accepts transition yellow',       () => expect( light.transition('Yellow') ).toBe( true )   );
-    test('green now yellow',                () => expect( light.state()              ).toBe("Yellow") );
-
-    test('proceed is true',                 () => expect( light.action('Proceed')    ).toBe( true )   );
-    test('machine is now red',              () => expect( light.state()              ).toBe("Red")    );
-
-    test('refuses transition yellow',       () => expect( light.transition('Yellow') ).toBe( false )  );
-    test('green still green',               () => expect( light.state()              ).toBe("Red")    );
-    test('refuses transition red',          () => expect( light.transition('Red')    ).toBe( false )  );
-    test('green still green',               () => expect( light.state()              ).toBe("Red")    );
-    test('accepts transition green',        () => expect( light.transition('Green')  ).toBe( true )   );
-    test('red now green',                   () => expect( light.state()              ).toBe("Green")  );
-
-    test('proceed is true',                 () => expect( light.action('Proceed')    ).toBe( true )   );
-    test('machine is now yellow',           () => expect( light.state()              ).toBe("Yellow") );
-    test('proceed is true',                 () => expect( light.action('Proceed')    ).toBe( true )   );
-    test('machine is now red',              () => expect( light.state()              ).toBe("Red")    );
-
-  });
-
-});
-
-
-
-
-
-
-
-describe('Complex stop light', () => {
-
-  const light2 = new jssm.Machine({
-
-    start_states: ['off'],
-
-    transitions:[
-
-      { name:'turn_on',     kind: 'legal', forced_only: false, main_path: false, action:'power_on',  from:'off',    to:'red'},
-
-      {                     kind: 'legal', forced_only: false, main_path: false, action:'power_off', from:'red',    to:'off' },
-      {                     kind: 'legal', forced_only: false, main_path: false, action:'power_off', from:'yellow', to:'off' },
-      {                     kind: 'legal', forced_only: false, main_path: false, action:'power_off', from:'green',  to:'off' },
-
-      { name:'switch_warn', kind: 'legal', forced_only: false, main_path: false, action:'proceed',   from:'green',  to:'yellow' },
-      { name:'switch_halt', kind: 'legal', forced_only: false, main_path: false, action:'proceed',   from:'yellow', to:'red'    },
-      { name:'switch_go',   kind: 'legal', forced_only: false, main_path: false, action:'proceed',   from:'red',    to:'green'  }
-
-    ]
-
-  });
-
-  const r_states = light2.states();
-
-  test('has the right state count', () =>
-    expect(r_states.length).toBe(4));
-
-  ['red', 'yellow', 'green', 'off'].map(c =>
-    test(`has state "${c}"`, () =>
-      expect(r_states.includes(c)).toBe(true))
-  );
-
-  const r_names = light2.list_named_transitions();
-
-  test('has the right named transition count', () =>
-    expect(r_names.size).toBe(4));
-
-  ['turn_on', 'switch_warn', 'switch_halt', 'switch_go'].map(a =>
-    test(`has named transition "${a}"`, () =>
-      expect(r_names.has(a)).toBe(true))
-  );
-
-  test('has the right exit actions for red', () =>
-    expect(['power_off', 'proceed']).toEqual(light2.list_exit_actions('red')) );
-
-
-  describe('- `transition` walkthrough', () => {
-
-    test('machine starts off',    () => expect( light2.state()              ).toBe("off")    );
-    test('off refuses green',     () => expect( light2.transition('green')  ).toBe(false)    );
-    test('off refuses yellow',    () => expect( light2.transition('yellow') ).toBe(false)    );
-
-    test('off refuses proceed',   () => expect( light2.action('proceed')    ).toBe(false)    );
-
-    test('off accepts red',       () => expect( light2.transition('red')    ).toBe(true)     );
-    test('off is now red',        () => expect( light2.state()              ).toBe("red")    );
-    test('red refuses yellow',    () => expect( light2.transition('yellow') ).toBe(false)    );
-    test('red still red',         () => expect( light2.state()              ).toBe("red")    );
-    test('red refuses red',       () => expect( light2.transition('red')    ).toBe(false)    );
-    test('red still red 2',       () => expect( light2.state()              ).toBe("red")    );
-
-    test('red accepts green',     () => expect( light2.transition('green')  ).toBe(true)     );
-    test('red now green',         () => expect( light2.state()              ).toBe("green")  );
-    test('green refuses red',     () => expect( light2.transition('red')    ).toBe(false)    );
-    test('green still green',     () => expect( light2.state()              ).toBe("green")  );
-    test('green refuses green',   () => expect( light2.transition('green')  ).toBe(false)    );
-    test('green still green 2',   () => expect( light2.state()              ).toBe("green")  );
-
-    test('green accepts yellow',  () => expect( light2.transition('yellow') ).toBe(true)     );
-    test('green now yellow',      () => expect( light2.state()              ).toBe("yellow") );
-    test('yellow refuses green',  () => expect( light2.transition('green')  ).toBe(false)    );
-    test('yellow still yellow',   () => expect( light2.state()              ).toBe("yellow") );
-    test('yellow refuses yellow', () => expect( light2.transition('yellow') ).toBe(false)    );
-    test('yellow still yellow 2', () => expect( light2.state()              ).toBe("yellow") );
-
-    test('yellow accepts red',    () => expect( light2.transition('red')    ).toBe(true)     );
-    test('back to red',           () => expect( light2.state()              ).toBe("red")    );
-
-    test('proceed is true',       () => expect( light2.action('proceed')    ).toBe(true)     );
-    test('light is now green',    () => expect( light2.state()              ).toBe("green")  );
-
-  });
-
-});

package/src/ts/tests/stripes.spec.ts

@@ -1,52 +0,0 @@
-
-/* eslint-disable max-len */
-
-import * as jssm from '../jssm';
-
-
-
-
-
-describe('stripe strategies', () => {
-
-
-
-  const is_v = (str, v) =>
-    test(str, () =>
-      expect( jssm.parse(str) ).toEqual(v)
-    );
-
-
-
-  describe('basic stripe', () => {
-    is_v(
-      '[a b c] -> +|1;',
-      [{from: ['a','b','c'], key: 'transition', se: {kind: '->', to: {key: 'stripe', value: 1}}}]
-    );
-  });
-
-  describe('negative stripe', () => {
-    is_v(
-      '[a b c] -> -|1;',
-      [{from: ['a','b','c'], key: 'transition', se: {kind: '->', to: {key: 'stripe', value: -1}}}]
-    );
-  });
-
-  describe('wide stripe', () => {
-    is_v(
-      '[a b c] -> +|2;',
-      [{from: ['a','b','c'], key: 'transition', se: {kind: '->', to: {key: 'stripe', value: 2}}}]
-    );
-  });
-
-
-
-  test('illegal fractional stripe throws', () => {
-
-    expect( () =>
-      jssm.parse('[a b c] -> +|2.5;')
-    ).toThrow();
-
-  });
-
-});

package/src/ts/tests/theme.spec.ts

@@ -1,45 +0,0 @@
-
-import { Themes } from './constants.spec';
-
-import { sm } from '../jssm';
-
-
-
-
-
-const baseline       = sm`theme: ocean; z -> q;`,
-      baseline_theme = baseline.theme();
-
-test('Themes sound like the ocean', () =>
-  expect(baseline_theme).toBe('ocean') );
-
-
-
-const no_baseline       = sm`z -> q;`,
-      no_baseline_theme = no_baseline.theme();
-
-test('No theme sounds like none', () =>
-  expect(no_baseline_theme).toBe('default') );
-
-
-
-
-
-describe('Named themes', () => {
-
-  Themes.map(thisTheme =>
-    test(`Theme "${thisTheme}" parses as a theme`, () =>
-      expect( () => { const _foo = sm`theme: ${thisTheme}; a-> b;`; }).not.toThrow() ) );
-
-  Themes.map(thisTheme =>
-    test(`Theme "${thisTheme}" shows correct theme`, () =>
-      expect( sm`theme: ${thisTheme}; a-> b;`.theme() ).toBe(thisTheme) ) );
-
-  Themes.map(thisTheme =>
-    test(`Missing theme shows theme "default"`, () =>
-      expect( sm`a-> b;`.theme() ).toBe("default") ) );
-
-  test('Fake theme throws', () =>
-    expect( () => { const _foo = sm`theme: zeghezgqqqqthirteen; a-> b;`; }).toThrow() );
-
-});

package/src/ts/tests/weighted_histo_key.spec.ts

@@ -1,22 +0,0 @@
-
-import * as jssm from '../jssm';
-
-
-
-
-
-describe('weighted_histo_key/2', () => {
-
-  const fruit = [ { label: 'apple',  probability: 0.1 },
-                  { label: 'orange', probability: 0.4 },
-                  { label: 'banana', probability: 0.5 } ];
-
-  const out = jssm.weighted_histo_key(10000, fruit, 'probability', 'label');
-
-  test('produces a well formed probability map', () =>
-    expect([... out.keys()].length).toBe(3)
-  );
-
-});
-
-// stochable

package/src/ts/tests/weighted_rand_select.spec.ts

@@ -1,27 +0,0 @@
-
-import * as jssm from '../jssm';
-
-
-
-
-
-describe('weighted_rand_select/2', () => {
-
-  const fruit = [ { label: 'apple',  probability: 0.1 },
-                  { label: 'orange', probability: 0.4 },
-                  { label: 'banana', probability: 0.5 } ];
-
-  const acc = { apple: 0, orange: 0, banana: 0 };
-
-  for (let i=0; i<10000; ++i) {
-    acc[jssm.weighted_rand_select(fruit).label] = acc[jssm.weighted_rand_select(fruit).label] + 1;
-  }
-
-  test('banana baseline',                () => expect( acc.banana > 3000 ).toBe(true) );
-
-  test('requires an array',              () => expect( () => jssm.weighted_rand_select( 'not_an_array' )).toThrow() );
-  test('requires members to be objects', () => expect( () => jssm.weighted_rand_select( ['not_an_obj'] )).toThrow() );
-
-});
-
-// stochable

package/src/ts/tests/weighted_sample_select.spec.ts

@@ -1,24 +0,0 @@
-
-import * as jssm from '../jssm';
-
-
-
-
-
-describe('weighted_sample_select/2', () => {
-
-  const fruit = [ { label: 'apple',  probability: 0.1 },
-                  { label: 'orange', probability: 0.4 },
-                  { label: 'banana', probability: 0.5 } ];
-
-  const none = jssm.weighted_sample_select(0, fruit),
-        one  = jssm.weighted_sample_select(1, fruit),
-        some = jssm.weighted_sample_select(2, fruit),
-        over = jssm.weighted_sample_select(4, fruit);
-
-  test('0 returns []',                () => expect(none.length).toBe(0) );
-  test('1 returns [any]',             () => expect(one.length ).toBe(1) );
-  test('2 returns [any,any]',         () => expect(some.length).toBe(2) );
-  test('4 returns [any,any,any,any]', () => expect(over.length).toBe(4) );
-
-});

package/src/ts/version.ts

@@ -1,3 +0,0 @@
-
-const version: string = "5.45.2";
-export { version };