piral-containers

Piral Containers ·

This is a plugin that only has a peer dependency to piral-core. What piral-containers brings to the table is a set of Pilet API extensions that can be used with piral or piral-core.

By default, these API extensions are not integrated in piral, so you'd need to add them to your Piral instance.

Documentation

The following functions are brought to the Pilet API.

createState()

Creates a new pilet global state container. The state container will essentially couple to the app shell global state container. It is, however, only available for use inside the pilet.

Usage

For authors of pilets

You can use the createState function from the Pilet API to create your own sub states in the global state container of the Piral instance.

Example use:

import { PiletApi } from '<name-of-piral-instance>';
import { MyPage } from './MyPage';

export function setup(piral: PiletApi) {
  const connect = piral.createState({
    state: {
      count: 0,
    },
    actions: {
      increment(dispatch) {
        dispatch(state => ({
          count: state.count + 1,
        }));
      },
      decrement(dispatch) {
        dispatch(state => ({
          count: state.count - 1,
        }));
      },
    },
  });
  piral.registerPage(
    '/sample',
    connect(({ state, actions }) => <MyPage count={state.count} {...actions} />),
  );
}

Setup and Bootstrapping

For Piral instance developers

The provided library only brings API extensions for pilets to a Piral instance.

For the setup of the library itself you'll need to import createContainersApi from the piral-containers package.

import { createContainersApi } from 'piral-containers';

The integration looks like:

const instance = createInstance({
  // important part
  extendApi: [createContainersApi()],
  // ...
});

There are no options available.

License

Piral is released using the MIT license. For more information see the license file.

Changelog

0.10.0 (February 2, 2020)

• Introduce compatibility check for the Piral CLI (#94)
• Added new optional plugin piral-mithril for Mithril.js (#79)
• Added new optional plugin piral-aurelia for Aurelia (#80)
• Added new optional plugin piral-litel for LitElement (#85)
• Added new optional plugin piral-ember for Ember.js (#96)
• Added new optional plugin piral-svelte for Svelte (#97)
• Added new optional plugin piral-elm for Elm (#118)
• Added new optional plugin piral-riot for Riot.js
• Added new optional plugin piral-react-15 for React v15
• Added new optional plugin piral-lazy for generic lazy loading
• Replaced react-arbiter with piral-base (#109)
• Changed --skip-install (default: false) flag to --install (default: true) for scaffolding
• Changed --only-core to --framework (supporting piral-base)
• Changed --tag to be a positional argument (for pilet upgrade)
• Allow async setup in pilets
• Support for teardown function in pilets
• Added dispatch and readState actions
• Allow async pilet module evaluation
• Integrated state and router in foreign context
• Introduced additional checks for missing files (#129)
• Changed generation of the Piral instance declaration (#116)