*/ class MarkupNode implements ModelInterface, ArrayAccess, \JsonSerializable { public const DISCRIMINATOR = null; /** * The original name of the model. * * @var string */ protected static $openAPIModelName = 'MarkupNode'; /** * Array of property to type mappings. Used for (de)serialization * * @var string[] */ protected static $openAPITypes = [ 'type' => 'string', 'value' => 'string', 'tag' => 'string', 'attrs' => 'array', 'children' => '\WikipaliApi\Model\MarkupNode[]', 'name' => 'string', 'props' => 'array' ]; /** * Array of property to format mappings. Used for (de)serialization * * @var string[] * @phpstan-var array * @psalm-var array */ protected static $openAPIFormats = [ 'type' => null, 'value' => null, 'tag' => null, 'attrs' => null, 'children' => null, 'name' => null, 'props' => null ]; /** * Array of nullable properties. Used for (de)serialization * * @var boolean[] */ protected static array $openAPINullables = [ 'type' => false, 'value' => false, 'tag' => false, 'attrs' => false, 'children' => false, 'name' => false, 'props' => false ]; /** * If a nullable field gets set to null, insert it here * * @var boolean[] */ protected array $openAPINullablesSetToNull = []; /** * Array of property to type mappings. Used for (de)serialization * * @return array */ public static function openAPITypes() { return self::$openAPITypes; } /** * Array of property to format mappings. Used for (de)serialization * * @return array */ public static function openAPIFormats() { return self::$openAPIFormats; } /** * Array of nullable properties * * @return array */ protected static function openAPINullables(): array { return self::$openAPINullables; } /** * Array of nullable field names deliberately set to null * * @return boolean[] */ private function getOpenAPINullablesSetToNull(): array { return $this->openAPINullablesSetToNull; } /** * Setter - Array of nullable field names deliberately set to null * * @param boolean[] $openAPINullablesSetToNull */ private function setOpenAPINullablesSetToNull(array $openAPINullablesSetToNull): void { $this->openAPINullablesSetToNull = $openAPINullablesSetToNull; } /** * Checks if a property is nullable * * @param string $property * @return bool */ public static function isNullable(string $property): bool { return self::openAPINullables()[$property] ?? false; } /** * Checks if a nullable property is set to null. * * @param string $property * @return bool */ public function isNullableSetToNull(string $property): bool { return in_array($property, $this->getOpenAPINullablesSetToNull(), true); } /** * Array of attributes where the key is the local name, * and the value is the original name * * @var string[] */ protected static $attributeMap = [ 'type' => 'type', 'value' => 'value', 'tag' => 'tag', 'attrs' => 'attrs', 'children' => 'children', 'name' => 'name', 'props' => 'props' ]; /** * Array of attributes to setter functions (for deserialization of responses) * * @var string[] */ protected static $setters = [ 'type' => 'setType', 'value' => 'setValue', 'tag' => 'setTag', 'attrs' => 'setAttrs', 'children' => 'setChildren', 'name' => 'setName', 'props' => 'setProps' ]; /** * Array of attributes to getter functions (for serialization of requests) * * @var string[] */ protected static $getters = [ 'type' => 'getType', 'value' => 'getValue', 'tag' => 'getTag', 'attrs' => 'getAttrs', 'children' => 'getChildren', 'name' => 'getName', 'props' => 'getProps' ]; /** * Array of attributes where the key is the local name, * and the value is the original name * * @return array */ public static function attributeMap() { return self::$attributeMap; } /** * Array of attributes to setter functions (for deserialization of responses) * * @return array */ public static function setters() { return self::$setters; } /** * Array of attributes to getter functions (for serialization of requests) * * @return array */ public static function getters() { return self::$getters; } /** * The original name of the model. * * @return string */ public function getModelName() { return self::$openAPIModelName; } public const TYPE_TEXT = 'text'; public const TYPE_EL = 'el'; public const TYPE_TPL = 'tpl'; /** * Gets allowable values of the enum * * @return string[] */ public function getTypeAllowableValues() { return [ self::TYPE_TEXT, self::TYPE_EL, self::TYPE_TPL, ]; } /** * Associative array for storing property values * * @var mixed[] */ protected $container = []; /** * Constructor * * @param mixed[]|null $data Associated array of property values * initializing the model */ public function __construct(?array $data = null) { $this->setIfExists('type', $data ?? [], null); $this->setIfExists('value', $data ?? [], null); $this->setIfExists('tag', $data ?? [], null); $this->setIfExists('attrs', $data ?? [], null); $this->setIfExists('children', $data ?? [], null); $this->setIfExists('name', $data ?? [], null); $this->setIfExists('props', $data ?? [], null); } /** * Sets $this->container[$variableName] to the given data or to the given default Value; if $variableName * is nullable and its value is set to null in the $fields array, then mark it as "set to null" in the * $this->openAPINullablesSetToNull array * * @param string $variableName * @param array $fields * @param mixed $defaultValue */ private function setIfExists(string $variableName, array $fields, $defaultValue): void { if (self::isNullable($variableName) && array_key_exists($variableName, $fields) && is_null($fields[$variableName])) { $this->openAPINullablesSetToNull[] = $variableName; } $this->container[$variableName] = $fields[$variableName] ?? $defaultValue; } /** * Show all the invalid properties with reasons. * * @return array invalid properties with reasons */ public function listInvalidProperties() { $invalidProperties = []; if ($this->container['type'] === null) { $invalidProperties[] = "'type' can't be null"; } $allowedValues = $this->getTypeAllowableValues(); if (!is_null($this->container['type']) && !in_array($this->container['type'], $allowedValues, true)) { $invalidProperties[] = sprintf( "invalid value '%s' for 'type', must be one of '%s'", $this->container['type'], implode("', '", $allowedValues) ); } if ($this->container['value'] === null) { $invalidProperties[] = "'value' can't be null"; } if ($this->container['tag'] === null) { $invalidProperties[] = "'tag' can't be null"; } if ($this->container['children'] === null) { $invalidProperties[] = "'children' can't be null"; } if ($this->container['name'] === null) { $invalidProperties[] = "'name' can't be null"; } if ($this->container['props'] === null) { $invalidProperties[] = "'props' can't be null"; } return $invalidProperties; } /** * Validate all the properties in the model * return true if all passed * * @return bool True if all properties are valid */ public function valid() { return count($this->listInvalidProperties()) === 0; } /** * Gets type * * @return string */ public function getType() { return $this->container['type']; } /** * Sets type * * @param string $type type * * @return self */ public function setType($type) { if (is_null($type)) { throw new \InvalidArgumentException('non-nullable type cannot be null'); } $allowedValues = $this->getTypeAllowableValues(); if (!in_array($type, $allowedValues, true)) { throw new \InvalidArgumentException( sprintf( "Invalid value '%s' for 'type', must be one of '%s'", $type, implode("', '", $allowedValues) ) ); } $this->container['type'] = $type; return $this; } /** * Gets value * * @return string */ public function getValue() { return $this->container['value']; } /** * Sets value * * @param string $value value * * @return self */ public function setValue($value) { if (is_null($value)) { throw new \InvalidArgumentException('non-nullable value cannot be null'); } $this->container['value'] = $value; return $this; } /** * Gets tag * * @return string */ public function getTag() { return $this->container['tag']; } /** * Sets tag * * @param string $tag 白名单内的 HTML 标签名(小写) * * @return self */ public function setTag($tag) { if (is_null($tag)) { throw new \InvalidArgumentException('non-nullable tag cannot be null'); } $this->container['tag'] = $tag; return $this; } /** * Gets attrs * * @return array|null */ public function getAttrs() { return $this->container['attrs']; } /** * Sets attrs * * @param array|null $attrs attrs * * @return self */ public function setAttrs($attrs) { if (is_null($attrs)) { throw new \InvalidArgumentException('non-nullable attrs cannot be null'); } $this->container['attrs'] = $attrs; return $this; } /** * Gets children * * @return \WikipaliApi\Model\MarkupNode[] */ public function getChildren() { return $this->container['children']; } /** * Sets children * * @param \WikipaliApi\Model\MarkupNode[] $children children * * @return self */ public function setChildren($children) { if (is_null($children)) { throw new \InvalidArgumentException('non-nullable children cannot be null'); } $this->container['children'] = $children; return $this; } /** * Gets name * * @return string */ public function getName() { return $this->container['name']; } /** * Sets name * * @param string $name 前端组件名:term、note、sentread、sentedit、quote、quote-link、mermaid… * * @return self */ public function setName($name) { if (is_null($name)) { throw new \InvalidArgumentException('non-nullable name cannot be null'); } $this->container['name'] = $name; return $this; } /** * Gets props * * @return array */ public function getProps() { return $this->container['props']; } /** * Sets props * * @param array $props props * * @return self */ public function setProps($props) { if (is_null($props)) { throw new \InvalidArgumentException('non-nullable props cannot be null'); } $this->container['props'] = $props; return $this; } /** * Returns true if offset exists. False otherwise. * * @param integer|string $offset Offset * * @return boolean */ public function offsetExists(mixed $offset): bool { return isset($this->container[$offset]); } /** * Gets offset. * * @param integer|string $offset Offset * * @return mixed|null */ #[\ReturnTypeWillChange] public function offsetGet(mixed $offset) { return $this->container[$offset] ?? null; } /** * Sets value based on offset. * * @param int|null $offset Offset * @param mixed $value Value to be set * * @return void */ public function offsetSet($offset, $value): void { if (is_null($offset)) { $this->container[] = $value; } else { $this->container[$offset] = $value; } } /** * Unsets offset. * * @param integer|string $offset Offset * * @return void */ public function offsetUnset(mixed $offset): void { unset($this->container[$offset]); } /** * Serializes the object to a value that can be serialized natively by json_encode(). * @link https://www.php.net/manual/en/jsonserializable.jsonserialize.php * * @return mixed Returns data which can be serialized by json_encode(), which is a value * of any type other than a resource. */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ObjectSerializer::sanitizeForSerialization($this); } /** * Gets the string presentation of the object * * @return string */ public function __toString() { return json_encode( ObjectSerializer::sanitizeForSerialization($this), JSON_PRETTY_PRINT ); } /** * Gets a header-safe presentation of the object * * @return string */ public function toHeaderValue() { return json_encode(ObjectSerializer::sanitizeForSerialization($this)); } }