Common Types Plugin

This plugin exposes some basic DataTypes, validations, and formats into Player content.

It also serves as a good reference to adding your own custom types into Player.

Usage

Install the plugin:

yarn add @player-ui/common-types-plugin

Add it to Player:

import CommonTypesPlugin from '@player-ui/common-types-plugin';

const commonTypesPlugin = new CommonTypesPlugin();
const player = new Player({ plugins: [commonTypesPlugin] });

// Start your flow
player.start(myFlow);

This will allow any DataTypes, formats, validations and custom data types to be used in the content

CocoaPods

Add the subspec to your Podfile

pod 'PlayerUI/CommonTypesPlugin'

Swift Usage

This plugin takes no parameters, and the configuration comes from content, it can just be added to the plugin array:

var body: some View {
    SwiftUIPlayer(
        flow: flow,
        plugins: [
          CommonTypesPlugin()
        ],
        result: $resultBinding
    )
}

Formats

commaNumber

format: Formats a number (or string containing only numbers) into a comma delineated string.
deformat: Converts a comma delineated string into a number

Options:

{
  precision?: number
}

integer

deformat: converts a string containing only integers to an integer

date

format: Formats a string of numbers into a slash separated date

Options:

{
  mask?: string
}

currency

format: Formats a number of string into a currency value
deformat: Converts a currency value into a number

Options:

{
  precision?: number;
  currencySymbol?: string;
  useParensForNeg?: boolean;
}

phone

format: Formats the value as a phone number

Options:

{
  mask?: string;
}

Validations

required

Asserts that a value is not null, undefined, or an empty string

Options:

{
  /** An expression to limit the assertion only if the expression evaluates to truthy **/
  if?: Expression;

  /** An expression to limit the assertion only if the expression evaluates to falsy **/
  ifNot?: Expression;
}

Constants Support:

namespace: constants
path: validation.required
message: “A value is required”

expression

Uses an expression to evaluate the validation assertion

Options:

{
  /** The expression to evaluate. If truthy, the value/validation passes. If falsy, it does not. **/
  exp: Expression;
}

Constants Support:

namespace: constants
path: validation.expression
message: “Expression evaluation failed”

readonly

Asserts that the value cannot change

Constants Support:

namespace: constants
path: validation.readonly
message: “Value cannot be modified”

string

Asserts that the value is a string

Constants Support:

namespace: constants
path: validation.string
message: “Value must be a string”
parameters:
- type: the type of value being validated

integer

Asserts that the value is an integer

Constants Support:

namespace: constants
path: validation.integer
message: “Value must be an integer”
parameters:
- type: the type of value being validated
- flooredValue: the floored value of the value being validated

collection

Asserts that the value is an array

Constants Support:

namespace: constants
path: validation.collection
message: “Cannot set collection to non-array”

oneOf

Asserts that the value is one of the pre-defined accepted values

Options:

{
  options?: Array;
}

Constants Support:

namespace: constants
path: validation.oneof
message: “Cannot set collection to non-array”

regex

Asserts that the value matches the provided regular expression

Options:

{
  regex: RegExp;
}

Constants Support:

namespace: constants
path: validation.regex

length

Asserts that the value matches the given length criteria. Uses character counts for strings, and key-length for objects, and array length for arrays.

Options:

{
  min?: number;
  max?: number;
  exact?: number;
}

Constants Support:

namespace: constants
path: validation.minimum, validation.maximum
message: “At least ${min} items needed”, “Up to ${max} items allowed”
parameters:
- validationLength: Returns the length of the value being validated