Charcoal\Admin\Widget\FormPropertyWidget

Complexity

Total Complexity

180

Size/Duplication

Total Lines	1504
Duplicated Lines	0 %

Importance

Changes

0

76 Methods

Rating	Name	Duplication	Size	Complexity
A	prop()	0	3	1
A	notes()	0	3	1
A	propertyVal()	0	3	1
A	l10nMode()	0	3	1
A	setL10nMode()	0	4	1
A	inputName()	0	3	1
A	formGroup()	0	3	1
A	loopL10n()	0	3	1
A	displayName()	0	3	1
A	propertyType()	0	3	1
A	supportedOutputTypes()	0	3	1
A	l10n()	0	3	1
A	description()	0	3	1
A	displayId()	0	3	1
A	hidden()	0	3	2
A	propertyIdent()	0	3	1
A	icon()	0	3	1
A	propertyData()	0	3	1
A	defaultFormGroupCssClasses()	0	3	1
A	inputId()	0	3	1
A	resolveDisplayType()	0	17	5
A	setPropertyType()	0	16	3
A	propertyDisplayFactory()	0	9	2
A	formGroupCssClass()	0	7	2
A	setShowDescription()	0	5	1
A	mergePropertyData()	0	13	3
A	resolveOutputType()	0	12	4
A	setInputType()	0	16	3
A	setType()	0	20	4
A	showNotesAbove()	0	15	3
A	setOutputType()	0	20	4
A	formFieldCssClass()	0	7	2
A	widgetId()	0	22	4
A	hasIcon()	0	7	2
A	addFormGroupCssClass()	0	5	1
A	property()	0	7	2
B	output()	0	38	6
A	setPropertyDisplayFactory()	0	5	1
A	showLabel()	0	16	4
A	clearFormGroup()	0	5	1
A	setData()	0	14	1
A	showNotes()	0	16	4
A	setPropertyVal()	0	5	1
A	resolvedOutputType()	0	8	3
A	showDescription()	0	16	4
A	propertyInputFactory()	0	9	2
A	setDisplayType()	0	16	3
A	merge()	0	11	1
A	setIcon()	0	5	1
A	setFormGroupCssClass()	0	5	1
A	addFormFieldCssClass()	0	5	1
A	createProperty()	0	19	4
B	outputType()	0	21	8
A	propertyFactory()	0	9	2
A	setPropertyFactory()	0	5	1
A	displayType()	0	7	2
A	setShowNotes()	0	5	2
A	setPropertyData()	0	13	3
A	inputNameAsCssClass()	0	6	1
A	setFormFieldCssClass()	0	5	1
A	createInputProperty()	0	27	5
A	setProperty()	0	17	3
A	display()	0	7	2
A	setPropertyInputFactory()	0	5	1
A	setPropertyIdent()	0	11	2
A	setFormGroup()	0	5	1
C	resolveInputType()	0	38	14
A	setCoreData()	0	23	6
A	input()	0	7	2
A	showActiveLanguage()	0	6	2
A	setDependencies()	0	8	1
A	inputType()	0	7	2
A	createDisplayProperty()	0	25	5
A	setShowLabel()	0	5	1
A	defaultFormFieldCssClasses()	0	25	6
A	parseCssClasses()	0	11	3

<?php

namespace Charcoal\Admin\Widget;

use LogicException;
use RuntimeException;
use InvalidArgumentException;
use UnexpectedValueException;

// From Pimple
use Pimple\Container;

// From 'charcoal-factory'
use Charcoal\Factory\FactoryInterface;

// From 'charcoal-property'
use Charcoal\Property\PropertyInterface;

// From 'charcoal-view'
use Charcoal\View\ViewableInterface;

// From 'charcoal-ui'
use Charcoal\Ui\FormGroup\FormGroupInterface;
use Charcoal\Ui\FormInput\FormInputInterface;

// From 'charcoal-admin'
use Charcoal\Admin\AdminWidget;

/**
 * Form Control Widget
 *
 * For model properties.
 */
class FormPropertyWidget extends AdminWidget implements
    FormInputInterface
{
    const HIDDEN_FORM_CONTROL     = 'charcoal/admin/property/input/hidden';
    const DEFAULT_FORM_CONTROL    = 'charcoal/admin/property/input/text';

    const PROPERTY_CONTROL = 'input';
    const PROPERTY_DISPLAY = 'display';
    const DEFAULT_OUTPUT   = self::PROPERTY_CONTROL;

    /**
     * The widget's type.
     *
     * @var string|null
     */
    protected $type;

    /**
     * The widget's property output type.
     *
     * @var string
     */
    protected $outputType;

    /**
     * Store the model property.
     *
     * @var PropertyInterface|null
     */
    private $property;

    /**
     * The model's property type.
     *
     * @var string|null
     */
    protected $propertyType;

    /**
     * The model property's name.
     *
     * @var string|null
     */
    private $propertyIdent;

    /**
     * The model property's value.
     *
     * @var mixed
     */
    private $propertyVal;

    /**
     * The model property's metadata.
     *
     * @var array
     */
    private $propertyData = [];

    /**
     * Store the property control instance.
     *
     * @var PropertyInputInterface|null

The type Charcoal\Admin\Widget\PropertyInputInterface was not found. Maybe you did not declare it correctly or list all dependencies?

     */
    private $inputProperty;

    /**
     * The property control type.
     *
     * @var string|null
     */
    protected $inputType;

    /**
     * Store the property display instance.
     *
     * @var PropertyDisplayInterface|null

The type Charcoal\Admin\Widget\PropertyDisplayInterface was not found. Maybe you did not declare it correctly or list all dependencies?

     */
    private $displayProperty;

    /**
     * The property display type.
     *
     * @var string|null
     */
    protected $displayType;

    /**
     * The label is displayed by default.
     *
     * @var boolean
     */
    protected $showLabel;

    /**
     * The description is displayed by default.
     *
     * @var boolean
     */
    protected $showDescription;

    /**
     * The notes are displayed by default.
     *
     * @var boolean
     */
    protected $showNotes;

    /**
     * The CSS class names for the `.form-field`.
     *
     * @var string[]
     */
    protected $formFieldCssClass = [];

    /**
     * The CSS class names for the `.form-group`.
     *
     * @var string[]
     */
    protected $formGroupCssClass = [];

    /**
     * The L10N display mode.
     *
     * @var string
     */
    private $l10nMode;

    /**
     * The form group the input belongs to.
     *
     * @var FormGroupInterface
     */
    protected $formGroup;

    /**
     * Store the model property factory.
     *
     * @var FactoryInterface
     */
    private $propertyFactory;

    /**
     * Store the property form control factory.
     *
     * @var FactoryInterface
     */
    private $propertyInputFactory;

    /**
     * Store the property display factory.
     *
     * @var FactoryInterface
     */
    private $propertyDisplayFactory;

    /**
     * Track the state of data merging.
     *
     * @var boolean
     */
    private $isMergingWidgetData = false;

    /**
     * The UI item's icon.
     *
     * Note: Only icons from the {@link http://fontawesome.io/ Font Awesome}
     * library are supported.
     *
     * @var string|null
     */
    private $icon;

    /**
     * Retrieve the property factory.
     *
     * @throws RuntimeException If the property factory is missing.
     * @return FactoryInterface
     */
    public function propertyFactory()
    {
        if ($this->propertyFactory === null) {
            throw new RuntimeException(
                'Missing Property Factory'
            );
        }

        return $this->propertyFactory;
    }



    /**
     * Retrieve the property control factory.
     *
     * @throws RuntimeException If the property control factory is missing.
     * @return FactoryInterface
     */
    public function propertyInputFactory()
    {
        if ($this->propertyInputFactory === null) {
            throw new RuntimeException(
                'Missing Property Input Factory'
            );
        }

        return $this->propertyInputFactory;
    }


    /**
     * Retrieve the property display factory.
     *
     * @throws RuntimeException If the property display factory is missing.
     * @return FactoryInterface
     */
    public function propertyDisplayFactory()
    {
        if ($this->propertyDisplayFactory === null) {
            throw new RuntimeException(
                'Missing Property Display Factory'
            );
        }

        return $this->propertyDisplayFactory;
    }

    /**
     * Retrieve the widget ID.
     *
     * @return string
     */
    public function widgetId()
    {
        if (!$this->widgetId) {
            $type = $this->type();
            switch ($type) {
                case static::PROPERTY_DISPLAY:
                    $id = $this->display()->displayId();
                    break;

                case static::PROPERTY_CONTROL:
                    $id = $this->input()->inputId();
                    break;

                default:
                    $id = 'widget_'.uniqid();
                    break;
            }

            $this->widgetId = $id;
        }

        return $this->widgetId;
    }

    /**
     * Set the widget or property type.
     *
     * @param  string $type The widget or property type.
     * @throws InvalidArgumentException If the argument is not a string.
     * @return FormPropertyWidget Chainable
     */
    public function setType($type)
    {
        if (empty($type)) {
            $this->type = null;
            return $this;
        }

        if (!is_string($type)) {

The condition is_string($type) is always true.

            throw new InvalidArgumentException(
                'Form property widget type must be a string'
            );
        }

        if ($this->propertyFactory()->isResolvable($type)) {
            $this->setPropertyType($type);
        }

        $this->type = $type;

        return $this;
    }

    /**
     * Set the model's property type.
     *
     * Can be either "input" or "display". A property input or property display identifier
     * is also accepted.
     *
     * @param  string $type The input or display property type.
     * @throws InvalidArgumentException If the argument is not a string.
     * @return FormPropertyWidget Chainable
     */
    public function setOutputType($type)
    {
        if (empty($type)) {
            $this->outputType = static::DEFAULT_OUTPUT;
            return $this;
        }

        if (!is_string($type)) {

The condition is_string($type) is always true.

            throw new InvalidArgumentException(
                'Form property widget type must be a string'
            );
        }

        if (!in_array($type, $this->supportedOutputTypes())) {
            $type = $this->resolveOutputType($type);
        }

        $this->outputType = $type;

        return $this;
    }

    /**
     * Retrieve the widget's property output type.
     *
     * Defaults to "input_type".
     *
     * @throws LogicException If the "input_type" and "display_type" are disabled.
     * @return string|null
     */
    public function outputType()
    {
        if ($this->outputType === null) {
            if ($this->inputType === false && $this->displayType === false) {

The condition $this->inputType === false is always false.

                throw new LogicException('Form property widget requires an "input_type" or a "display_type"');
            }

            $type = null;

            if ($this->inputType === false || is_string($this->displayType)) {
                $type = static::PROPERTY_DISPLAY;
            }

            if ($this->displayType === false || is_string($this->inputType)) {
                $type = static::PROPERTY_CONTROL;
            }

            $this->outputType = $type;
        }

        return $this->outputType;
    }

    /**
     * Retrieve the supported property output types.
     *
     * @return array
     */
    public function supportedOutputTypes()
    {
        return [ static::PROPERTY_CONTROL, static::PROPERTY_DISPLAY ];
    }

    /**
     * Set the form input's parent group.
     *
     * @param  FormGroupInterface $formGroup The parent form group object.
     * @return FormPropertyWidget Chainable
     */
    public function setFormGroup(FormGroupInterface $formGroup)
    {
        $this->formGroup = $formGroup;

        return $this;
    }

    /**
     * Retrieve the input's parent group.
     *
     * @return FormGroupInterface
     */
    public function formGroup()
    {
        return $this->formGroup;
    }

    /**
     * Clear the input's parent group.
     *
     * @return FormPropertyWidget Chainable
     */
    public function clearFormGroup()
    {
        $this->formGroup = null;

        return $this;
    }



    /**
     * Set the widget and property data.
     *
     * @param  array|ArrayAccess $data Widget and property data.

The type Charcoal\Admin\Widget\ArrayAccess was not found. Did you mean ArrayAccess? If so, make sure to prefix the type with \.

     * @return FormPropertyWidget Chainable
     */
    public function setData(array $data)
    {
        $this->isMergingWidgetData = true;

        $data = $this->setCoreData($data);

        parent::setData($data);

        // Keep the data in copy, this will be passed to the property and/or input later
        $this->setPropertyData($data);

        $this->isMergingWidgetData = false;

        return $this;
    }

    /**
     * Merge widget and property data.
     *
     * @param  array $data Widget and property data.
     * @return FormPropertyWidget Chainable
     */
    public function merge(array $data)
    {
        $this->isMergingWidgetData = true;

        $data = $this->setCoreData($data);

        $this->mergePropertyData($data);

        $this->isMergingWidgetData = false;

        return $this;
    }

    /**
     * Set the model's property type.
     *
     * @param  string $type The property type.
     * @throws InvalidArgumentException If the argument is not a string.
     * @return FormPropertyWidget Chainable
     */
    public function setPropertyType($type)
    {
        if (empty($type)) {
            $this->propertyType = null;
            return $this;
        }

        if (!is_string($type)) {

The condition is_string($type) is always true.

            throw new InvalidArgumentException(
                'Property type must be a string'
            );
        }

        $this->propertyType = $type;

        return $this;
    }

    /**
     * Retrieve the model's property type.
     *
     * @return string|null
     */
    public function propertyType()
    {
        return $this->propertyType;
    }

    /**
     * Set the form's property identifier.
     *
     * @param  string $propertyIdent The property identifier.
     * @throws InvalidArgumentException If the property ident is not a string.
     * @return FormPropertyWidget Chainable
     */
    public function setPropertyIdent($propertyIdent)
    {
        if (!is_string($propertyIdent)) {

The condition is_string($propertyIdent) is always true.

            throw new InvalidArgumentException(
                'Property identifier must be a string'
            );
        }

        $this->propertyIdent = $propertyIdent;

        return $this;
    }

    /**
     * Retrieve the form's property identifier.
     *
     * @return string|null
     */
    public function propertyIdent()
    {
        return $this->propertyIdent;
    }

    /**
     * Set the property metadata.
     *
     * @param  array $data The property configset.
     * @return FormPropertyWidget Chainable
     */
    public function setPropertyData(array $data)
    {
        $this->propertyData = $data;

        if (!$this->isMergingWidgetData) {
            $this->setCoreData($this->propertyData);
        }

        if ($this->property) {
            $this->property->setData($data);
        }

        return $this;
    }

    /**
     * Merge the property metadata.
     *
     * @param  array $data The property configset.
     * @return FormPropertyWidget Chainable
     */
    public function mergePropertyData(array $data)
    {
        $this->propertyData = array_replace($this->propertyData, $data);

        if (!$this->isMergingWidgetData) {
            $this->setCoreData($this->propertyData);
        }

        if ($this->property) {
            $this->property->setData($data);
        }

        return $this;
    }

    /**
     * Retrieve the property metadata.
     *
     * @return array
     */
    public function propertyData()
    {
        return $this->propertyData;
    }

    /**
     * Set the property's value.
     *
     * @param  mixed $propertyVal The property value.
     * @return FormPropertyWidget Chainable
     */
    public function setPropertyVal($propertyVal)
    {
        $this->propertyVal = $propertyVal;

        return $this;
    }

    /**
     * Retrieve the property's value.
     *
     * @return mixed
     */
    public function propertyVal()
    {
        return $this->propertyVal;
    }

    /**
     * Show/hide the property's label.
     *
     * @param  boolean $show Show (TRUE) or hide (FALSE) the label.
     * @return FormPropertyWidget Chainable
     */
    public function setShowLabel($show)
    {
        $this->showLabel = !!$show;

        return $this;
    }

    /**
     * Determine if the label is to be displayed.
     *
     * @return boolean If TRUE or unset, check if there is a label.
     */
    public function showLabel()
    {
        if ($this->showLabel === null) {
            $prop = $this->property();
            $show = $prop['show_label'];
            if ($show !== null) {
                $this->showLabel = $show;
            } else {
                $this->showLabel = true;
            }
        }

        if ($this->showLabel !== false) {
            return !!strval($this->property()->label());
        } else {
            return false;
        }
    }

    /**
     * Show/hide the property's description.
     *
     * @param  boolean $show Show (TRUE) or hide (FALSE) the description.
     * @return FormPropertyWidget Chainable
     */
    public function setShowDescription($show)
    {
        $this->showDescription = !!$show;

        return $this;
    }

    /**
     * Determine if the description is to be displayed.
     *
     * @return boolean If TRUE or unset, check if there is a description.
     */
    public function showDescription()
    {
        if ($this->showDescription === null) {
            $prop = $this->property();
            $show = $prop['show_description'];
            if ($show !== null) {
                $this->showDescription = $show;
            } else {
                $this->showDescription = true;
            }
        }

        if ($this->showDescription !== false) {
            return !!strval($this->property()->description());
        } else {
            return false;
        }
    }

    /**
     * Show/hide the property's notes.
     *
     * @param  boolean|string $show Show (TRUE) or hide (FALSE) the notes.
     * @return FormPropertyWidget Chainable
     */
    public function setShowNotes($show)
    {
        $this->showNotes = ($show === 'above' ? $show : !!$show);

It seems like $show === 'above' ? $show : ! ! $show can also be of type string. However, the property $showNotes is declared as type boolean. Maybe add an additional type check?

        return $this;
    }

    /**
     * Determine if the notes is to be displayed.
     *
     * @return boolean If TRUE or unset, check if there are notes.
     */
    public function showNotes()
    {
        if ($this->showNotes === null) {
            $prop = $this->property();
            $show = $prop['show_notes'];
            if ($show !== null) {
                $this->showNotes = $show;
            } else {
                $this->showNotes = true;
            }
        }

        if ($this->showNotes !== false) {
            return !!strval($this->property()->notes());
        } else {
            return false;
        }
    }

    /**
     * @return boolean
     */
    public function showNotesAbove()
    {
        if ($this->showNotes === null) {
            $this->showNotes();
        }

        $show = $this->showNotes;

        if ($show !== 'above') {
            return false;
        }

        $notes = $this->property()->notes();

        return !!$notes;
    }

    /**
     * @return Translation|string|null

The type Charcoal\Admin\Widget\Translation was not found. Maybe you did not declare it correctly or list all dependencies?

     */
    public function description()
    {
        return $this->renderTemplate((string)$this->property()->description());
    }

    /**
     * @return Translation|string|null
     */
    public function notes()
    {
        return $this->renderTemplate((string)$this->property()->notes());
    }

    /**
     * @return boolean
     */
    public function hidden()
    {
        return ($this->inputType() === static::HIDDEN_FORM_CONTROL || $this->property()->hidden());
    }

    /**
     * @return string
     */
    public function inputId()
    {
        return 'input_id';
    }

    /**
     * @return string
     */
    public function inputName()
    {
        return 'input_name';
    }

    /**
     * @return string
     */
    public function displayId()
    {
        return 'display_id';
    }

    /**
     * @return string
     */
    public function displayName()
    {
        return 'display_name';
    }

    /**
     * Set the property control type.
     *
     * @param  string $type The form control type.
     * @throws InvalidArgumentException If the argument is not a string.
     * @return FormPropertyWidget Chainable
     */
    public function setInputType($type)
    {
        if (empty($type)) {
            $this->inputType = null;
            return $this;
        }

        if (!is_string($type)) {

The condition is_string($type) is always true.

            throw new InvalidArgumentException(
                'Property input type must be a string'
            );
        }

        $this->inputType = $type;

        return $this;
    }

    /**
     * Retrieve the property control type.
     *
     * @return string
     */
    public function inputType()
    {
        if ($this->inputType === null) {
            $this->inputType = $this->resolveInputType();
        }

        return $this->inputType;
    }

    /**
     * Set the property display type.
     *
     * @param  string $type The property display type.
     * @throws InvalidArgumentException If the argument is not a string.
     * @return FormPropertyWidget Chainable
     */
    public function setDisplayType($type)
    {
        if (empty($type)) {
            $this->displayType = null;
            return $this;
        }

        if (!is_string($type)) {

The condition is_string($type) is always true.

            throw new InvalidArgumentException(
                'Property display type must be a string'
            );
        }

        $this->displayType = $type;

        return $this;
    }

    /**
     * Retrieve the property display type.
     *
     * @return string
     */
    public function displayType()
    {
        if ($this->displayType === null) {
            $this->displayType = $this->resolveDisplayType();
        }

        return $this->displayType;
    }

    /**
     * Set the widget's model property.
     *
     * @param  PropertyInterface $property The property.
     * @return FormPropertyWidget Chainable
     */
    public function setProperty(PropertyInterface $property)
    {
        $this->property      = $property;
        $this->propertyType  = $property->type();
        $this->propertyIdent = $property->ident();

        $inputType = $property['input_type'];
        if ($inputType) {
            $this->inputType = $inputType;
        }

        $displayType = $property['display_type'];
        if ($displayType) {
            $this->displayType = $displayType;
        }

        return $this;
    }

    /**
     * Retrieve the widget's model property.
     *
     * @return PropertyInterface
     */
    public function property()
    {
        if ($this->property === null) {
            $this->property = $this->createProperty();
        }

        return $this->property;
    }

    /**
     * Alias of {@see self::property()}
     *
     * @return PropertyInterface
     */
    public function prop()
    {
        return $this->property();
    }

    /**
     * Determine if the form control's active language should be displayed.
     *
     * @see    FormSidebarWidget::showLanguageSwitch()
     * @return boolean
     */
    public function showActiveLanguage()
    {
        $property = $this->property();
        $locales  = count($this->translator()->availableLocales());

        return ($locales > 1 && $property->l10n());
    }

    /**
     * Generate a CSS class name for the property's input name.
     *
     * @return string
     */
    public function inputNameAsCssClass()
    {
        $name = str_replace([ ']', '[' ], [ '', '-' ], $this->propertyIdent());
        $name = $this->camelize($name);

        return $name;
    }

    /**
     * Set the CSS class name(s) for the `.form-field`.
     *
     * @param  mixed $cssClass One or more CSS class names.
     * @return self
     */
    public function setFormFieldCssClass($cssClass)
    {
        $cssClass = array_merge($this->defaultFormFieldCssClasses(), $this->parseCssClasses($cssClass));
        $this->formFieldCssClass = array_unique($cssClass);
        return $this;
    }

    /**
     * Add CSS class name(s) for the `.form-field`.
     *
     * @param  mixed $cssClass One or more CSS class names.
     * @return self
     */
    public function addFormFieldCssClass($cssClass)
    {
        $cssClass = array_merge($this->formFieldCssClass, $this->parseCssClasses($cssClass));
        $this->formFieldCssClass = array_unique($cssClass);
        return $this;
    }

    /**
     * Retrieve the CSS class name(s) for the `.form-field`.
     *
     * @return string
     */
    public function formFieldCssClass()
    {
        if (empty($this->formFieldCssClass)) {
            $this->formFieldCssClass = $this->defaultFormFieldCssClasses();
        }

        return implode(' ', $this->formFieldCssClass);
    }

    /**
     * Set the CSS class name(s) for the `.form-group`.
     *
     * @param  mixed $cssClass One or more CSS class names.
     * @return self
     */
    public function setFormGroupCssClass($cssClass)
    {
        $cssClass = array_merge($this->defaultFormGroupCssClasses(), $this->parseCssClasses($cssClass));
        $this->formGroupCssClass = array_unique($cssClass);
        return $this;
    }

    /**
     * Add CSS class name(s) for the `.form-group`.
     *
     * @param  mixed $cssClass One or more CSS class names.
     * @return self
     */
    public function addFormGroupCssClass($cssClass)
    {
        $cssClass = array_merge($this->formGroupCssClass, $this->parseCssClasses($cssClass));
        $this->formGroupCssClass = array_unique($cssClass);
        return $this;
    }

    /**
     * Retrieve the CSS class name(s) for the `.form-group`.
     *
     * @return string
     */
    public function formGroupCssClass()
    {
        if (empty($this->formGroupCssClass)) {
            $this->formGroupCssClass = $this->defaultFormGroupCssClasses();
        }

        return implode(' ', $this->formGroupCssClass);
    }

    /**
     * Set the L10N display mode.
     *
     * @param  string $mode The L10N display mode.
     * @return FormPropertyWidget Chainable
     */
    public function setL10nMode($mode)
    {
        $this->l10nMode = $mode;
        return $this;
    }

    /**
     * Retrieve the L10N display mode.
     *
     * @return string
     */
    public function l10nMode()
    {
        return $this->l10nMode;
    }

    /**
     * Determine if the property should output for each language.
     *
     * @return boolean
     */
    public function loopL10n()
    {
        return ($this->l10nMode() === 'loop_inputs');
    }

    /**
     * Alias of {@see PropertyInterface::l10n()}.
     *
     * @return boolean
     */
    public function l10n()
    {
        return $this->property()->l10n();
    }

    /**
     * Retrieve the form control property.
     *
     * @return PropertyInputInterface
     */
    public function input()
    {
        if ($this->inputProperty === null) {
            $this->inputProperty = $this->createInputProperty();
        }

        return $this->inputProperty;
    }

    /**
     * Retrieve the display property.
     *
     * @return PropertyDisplayInterface
     */
    public function display()
    {
        if ($this->displayProperty === null) {
            $this->displayProperty = $this->createDisplayProperty();
        }

        return $this->displayProperty;
    }

    /**
     * Yield the property output.
     *
     * Either a display property or a form control property.
     *
     * @return PropertyInputInterface|PropertyDisplayInterface
     */
    public function output()
    {
        $output = $this->outputType();
        switch ($output) {
            case static::PROPERTY_DISPLAY:
                $type   = $this->displayType();
                $prop   = $this->display();
                $getter = 'displayId';
                $setter = 'setDisplayId';
                break;

            case static::PROPERTY_CONTROL:
                $type   = $this->inputType();
                $prop   = $this->input();
                $getter = 'inputId';
                $setter = 'setInputId';
                break;
        }

        $GLOBALS['widget_template'] = $type;

The variable $type does not seem to be defined for all execution paths leading up to this point.

        if ($this->l10n() && $this->loopL10n()) {
            $locales  = $this->translator()->availableLocales();
            $outputId = $prop->{$getter}();

The variable $prop does not seem to be defined for all execution paths leading up to this point.

The variable $getter does not seem to be defined for all execution paths leading up to this point.

            foreach ($locales as $langCode) {
                // Set a unique property output ID for each locale.
                $prop->{$setter}($outputId.'_'.$langCode);

The variable $setter does not seem to be defined for all execution paths leading up to this point.

                $prop->setLang($langCode);

                yield $prop;

The expression yield $prop returns the type Generator which is incompatible with the documented return type Charcoal\Admin\Widget\PropertyDisplayInterface|Charcoal\Admin\Widget\PropertyInputInterface.

            }

            $GLOBALS['widget_template'] = '';
            $prop->{$setter}($outputId);
        } else {
            yield $prop;

            $GLOBALS['widget_template'] = '';
        }
    }

    /**
     * Set the widget's dependencies.
     *
     * @param  Container $container Service container.
     * @return void
     */
    protected function setDependencies(Container $container)
    {
        parent::setDependencies($container);

        $this->setView($container['view']);
        $this->setPropertyFactory($container['property/factory']);
        $this->setPropertyInputFactory($container['property/input/factory']);
        $this->setPropertyDisplayFactory($container['property/display/factory']);
    }

    /**
     * Set a property factory.
     *
     * @param  FactoryInterface $factory The factory to create property values.
     * @return FormPropertyWidget Chainable
     */
    protected function setPropertyFactory(FactoryInterface $factory)
    {
        $this->propertyFactory = $factory;

        return $this;
    }

    /**
     * Set a property control factory.
     *
     * @param  FactoryInterface $factory The factory to create form controls for property values.
     * @return FormPropertyWidget Chainable
     */
    protected function setPropertyInputFactory(FactoryInterface $factory)
    {
        $this->propertyInputFactory = $factory;

        return $this;
    }

    /**
     * Set a property display factory.
     *
     * @param  FactoryInterface $factory The factory to create displayable property values.
     * @return FormPropertyWidget Chainable
     */
    protected function setPropertyDisplayFactory(FactoryInterface $factory)
    {
        $this->propertyDisplayFactory = $factory;

        return $this;
    }

    /**
     * Resolve the property output type.
     *
     * Note: The "input_type" or "display_type" will be set
     * if the output type is a valid output property.
     *
     * @param  string $type The input or display property type.
     * @throws InvalidArgumentException If the property output type is invalid.
     * @return string Returns either "input" or "display".
     */
    protected function resolveOutputType($type)
    {
        if ($this->propertyInputFactory()->isResolvable($type)) {
            $this->setInputType($type);
            return static::PROPERTY_CONTROL;
        } elseif ($this->propertyDisplayFactory()->isResolvable($type)) {
            $this->setDisplayType($type);
            return static::PROPERTY_DISPLAY;
        } else {
            throw new InvalidArgumentException(sprintf(
                'Invalid form property output type, received %s',
                is_object($type) ? get_class($type) : gettype($type)

The condition is_object($type) is always false.

            ));
        }
    }

    /**
     * Retrieved the resolved the property output type.
     *
     * @return string|null Returns the property's "input_type" or "display_type".
     */
    protected function resolvedOutputType()
    {
        switch ($this->outputType()) {
            case static::PROPERTY_DISPLAY:
                return $this->displayType();

            case static::PROPERTY_CONTROL:
                return $this->inputType();
        }
    }

    /**
     * Retrieve the default CSS class name(s) for the `.form-field`.
     *
     * @return string[]
     */
    protected function defaultFormFieldCssClasses()
    {
        $classes = [ 'form-field', 'form-field-'.$this->widgetId() ];

        if ($this->prop()) {
            $classes[] = 'form-property-'.$this->inputNameAsCssClass();

            if ($this->prop()->type()) {
                $classes[] = 'form-property-'.$this->prop()->type();
            }

            if ($this->prop()->multiple()) {
                $classes[] = '-multiple';
            }
        }

        if ($this->showActiveLanguage()) {
            $classes[] = '-l10n';
        }

        if ($this->hidden()) {
            $classes[] = 'd-none';
        }

        return $classes;
    }

    /**
     * Retrieve the default CSS class name(s) for the `.form-group`.
     *
     * @return string[]
     */
    protected function defaultFormGroupCssClasses()
    {
        return [ 'form-group' ];
    }

    /**
     * Parse the CSS class name(s).
     *
     * @param  mixed $classes One or more CSS class names.
     * @throws InvalidArgumentException If a class name is not a string.
     * @return string[]
     */
    protected function parseCssClasses($classes)
    {
        if (is_string($classes)) {
            $classes = explode(' ', $classes);
        }

        if (!is_array($classes)) {
            throw new InvalidArgumentException('CSS Class(es) must be a space-delimited string or an array');
        }

        return array_filter($classes, 'strlen');
    }

    /**
     * Set the core data for the widget and property's first.
     *
     * @param  array $data The widget and property data.
     * @return array The widget and property data.
     */
    private function setCoreData(array $data)
    {
        if (isset($data['input_type'])) {
            $this->setInputType($data['input_type']);
        }

        if (isset($data['display_type'])) {
            $this->setDisplayType($data['display_type']);
        }

        if (isset($data['property_type'])) {
            $this->setPropertyType($data['property_type']);
        }

        if (isset($data['output_type'])) {
            $this->setOutputType($data['output_type']);
        }

        if (isset($data['type'])) {
            $this->setType($data['type']);
        }

        return $data;
    }

    /**
     * Resolve the property control type.
     *
     * @return string
     */
    private function resolveInputType()
    {
        $type = null;

        /** Attempt input type resolution without instantiating the property, at first. */
        $metadata = $this->propertyData();
        if ($metadata) {

The expression $metadata of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using ! empty($expr) instead to make it clear that you intend to check for an array without elements.

            if (isset($metadata['hidden']) && $metadata['hidden']) {
                $type = static::HIDDEN_FORM_CONTROL;
            }

            if (!$type && isset($metadata['input_type'])) {
                $type = $metadata['input_type'];
            }
        }

        if ($this->propertyType || $this->property) {
            $property = $this->property();
            $metadata = $property->metadata();

            if ($property->hidden()) {
                $type = static::HIDDEN_FORM_CONTROL;
            }

            if (!$type && isset($metadata['input_type'])) {
                $type = $metadata['input_type'];
            }

            if (!$type && isset($metadata['admin']['input_type'])) {
                $type = $metadata['admin']['input_type'];
            }
        }

        if (!$type) {
            $type = static::DEFAULT_FORM_CONTROL;
        }

        return $type;
    }

    /**
     * Resolve the property display type.
     *
     * @return string
     */
    private function resolveDisplayType()
    {
        $type = null;

        /** Attempt display type resolution without instantiating the property, at first. */
        $metadata = $this->propertyData();
        if ($metadata) {

The expression $metadata of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using ! empty($expr) instead to make it clear that you intend to check for an array without elements.

            if (isset($metadata['display_type'])) {
                $type = $metadata['display_type'];
            }
        }

        if ($this->propertyType || $this->property) {
            $type = $this->property()->displayType();

The method displayType() does not exist on Charcoal\Property\PropertyInterface. Did you maybe mean displayVal()?

        }

        return $type;
    }


    /**
     * Create the widget's model property from the property's dataset.
     *
     * @throws UnexpectedValueException If the property type is missing.
     * @return PropertyInterface
     */
    private function createProperty()
    {
        $propType = $this->propertyType();
        if (empty($propType)) {
            $ident = $this->propertyIdent();
            if ($ident && is_string($ident)) {
                $message = sprintf('Missing property type for property "%s"', $ident);
            } else {
                $message = sprintf('Missing property type');
            }
            throw new UnexpectedValueException($message);
        }

        $prop = $this->propertyFactory()->create($propType);

        $prop->setIdent($this->propertyIdent());
        $prop->setData($this->propertyData());

        return $prop;
    }

    /**
     * Create the widget's form control property.
     *
     * @return PropertyInputInterface
     */
    private function createInputProperty()
    {
        $prop  = $this->property();
        $type  = $this->inputType();
        $input = $this->propertyInputFactory()->create($type);

        if ($this->formGroup() && ($input instanceof FormInputInterface)) {
            $input->setFormGroup($this->formGroup());
        }

        if ($input instanceof ViewableInterface) {
            $input->setViewController($this->viewController());

The method setViewController() does not exist on Charcoal\View\ViewableInterface. Did you maybe mean setView()?

        }

        $metadata = $prop->metadata();
        $data = $prop->data();

        if (isset($metadata['admin'])) {
            $data = array_replace_recursive($metadata['admin'], $data);
        }

        $input->setInputType($type);

The method setInputType() does not exist on Charcoal\Ui\FormInput\FormInputInterface. It seems like you code against a sub-type of Charcoal\Ui\FormInput\FormInputInterface such as Charcoal\Admin\Property\Input\NestedWidgetInput or Charcoal\Admin\Widget\FormPropertyWidget.

        $input->setProperty($prop);

The method setProperty() does not exist on Charcoal\Ui\FormInput\FormInputInterface. It seems like you code against a sub-type of Charcoal\Ui\FormInput\FormInputInterface such as Charcoal\Admin\Property\Input\NestedWidgetInput or Charcoal\Admin\Widget\FormPropertyWidget.

        $input->setPropertyVal($this->propertyVal());

The method setPropertyVal() does not exist on Charcoal\Ui\FormInput\FormInputInterface. It seems like you code against a sub-type of Charcoal\Ui\FormInput\FormInputInterface such as Charcoal\Admin\Property\Input\NestedWidgetInput or Charcoal\Admin\Widget\FormPropertyWidget.

        $input->setData($data);

        return $input;

The expression return $input also could return the type Charcoal\Ui\FormInput\FormInputInterface which is incompatible with the documented return type Charcoal\Admin\Widget\PropertyInputInterface.

    }

    /**
     * Create the widget's display property.
     *
     * @return PropertyDisplayInterface
     */
    private function createDisplayProperty()
    {
        $prop    = $this->property();
        $type    = $this->displayType();
        $display = $this->propertyDisplayFactory()->create($type);

        if ($this->formGroup() && ($display instanceof FormInputInterface)) {
            $display->setFormGroup($this->formGroup());
        }

        if ($display instanceof ViewableInterface) {
            $display->setViewController($this->viewController());
        }

        $display->setDisplayType($type);

The method setDisplayType() does not exist on Charcoal\Ui\FormInput\FormInputInterface. It seems like you code against a sub-type of Charcoal\Ui\FormInput\FormInputInterface such as Charcoal\Admin\Widget\FormPropertyWidget.

        $display->setProperty($prop);
        $display->setPropertyVal($this->propertyVal());
        $display->setData($prop->data());

        $metadata = $prop->metadata();
        if (isset($metadata['admin'])) {
            $display->setData($metadata['admin']);
        }

        return $display;

The expression return $display also could return the type Charcoal\Ui\FormInput\FormInputInterface which is incompatible with the documented return type Charcoal\Admin\Widget\PropertyDisplayInterface.

    }

    /**
     * Retrieve the path to the item's icon.
     *
     * @return string
     */
    public function icon()
    {
        return $this->icon;
    }

    /**
     * Set the path to the item's icon associated with the object.
     *
     * @param  string $icon A path to an image.
     * @return self
     */
    public function setIcon($icon)
    {
        $this->icon = $icon;

        return $this;
    }

    /**
     * Check for icon(s)
     *
     * @return boolean
     */
    public function hasIcon()
    {
        if (is_array($this->icon())) {

The condition is_array($this->icon()) is always false.

            return !!count($this->icon());
        }

        return !!$this->icon();
    }
}