packages/sql-semantics-mysql/resources/models/Value/AlterListItemWithAddColumnCreateFieldList_2d7e8e00.php

1<?php
2
3declare(strict_types=1);
4
5namespace SqlSemantics\Statement\Model\MySql\Value;
6
7/**
8 * The alter_list_item SQL value; generated by bin/build-models.php.
9 *
10 * @visibility public
11 * @example Accept a structured SQL value
12 *     $write = static fn (\SqlSemantics\Statement\Model\MySql\Value\AlterListItemWithAddColumnCreateFieldList_2d7e8e00 $value): string => \SqlSemantics\Statement\Writer::render($value);
13 *     $write instanceof \Closure // => true
14 */
15final class AlterListItemWithAddColumnCreateFieldList_2d7e8e00 implements \SqlSemantics\Statement\Model\MySql\Role\AlterCommandListForm, \SqlSemantics\Statement\Model\MySql\Role\AlterCommandsForm, \SqlSemantics\Statement\Model\MySql\Role\AlterListForm, \SqlSemantics\Statement\Model\MySql\Role\AlterListItemForm, \SqlSemantics\Statement\Model\MySql\Role\OptAlterCommandListForm, \SqlSemantics\Statement\Model\MySql\Role\OptAlterTableActionsForm
16{
17    use \SqlSemantics\Statement\Assertion;
18
19    /**
20     * Supplies the SQL values of this form; comments are kept by the position of the symbol each precedes.
21     */
22    public function __construct(
23        public readonly \SqlSemantics\Statement\Model\MySql\Role\AddColumnForm $addColumn,
24        public readonly \SqlSemantics\Statement\Model\MySql\Role\CreateFieldListForm $createFieldList,
25        public readonly \SqlSemantics\Statement\Comments $comments = new \SqlSemantics\Statement\Comments(),
26    ) {
27        $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($addColumn), 'The addColumn must be a generated immutable SQL value.');
28        $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($createFieldList), 'The createFieldList must be a generated immutable SQL value.');
29    }
30
31    /**
32     * Writes SQL entirely from this value's fields.
33     */
34    public function write(\SqlSemantics\Statement\Writer $writer): void
35    {
36        $writer->comments($this->comments, 0);
37        $this->addColumn->write($writer);
38        $writer->comments($this->comments, 1);
39        $writer->append('(');
40        $writer->comments($this->comments, 2);
41        $this->createFieldList->write($writer);
42        $writer->comments($this->comments, 3);
43        $writer->append(')');
44    }
45
46    /**
47     * Returns a copy with a new addColumn, preserving every other field.
48     */
49    public function withAddColumn(\SqlSemantics\Statement\Model\MySql\Role\AddColumnForm $addColumn): self
50    {
51        return new self($addColumn, $this->createFieldList, $this->comments);
52    }
53
54    /**
55     * Returns a copy with a new createFieldList, preserving every other field.
56     */
57    public function withCreateFieldList(\SqlSemantics\Statement\Model\MySql\Role\CreateFieldListForm $createFieldList): self
58    {
59        return new self($this->addColumn, $createFieldList, $this->comments);
60    }
61
62    /**
63     * Returns a copy with a new comments, preserving every other field.
64     */
65    public function withComments(\SqlSemantics\Statement\Comments $comments): self
66    {
67        return new self($this->addColumn, $this->createFieldList, $comments);
68    }
69}
70