xref: /webtrees/app/Contracts/ElementFactoryInterface.php (revision d11be7027e34e3121be11cc025421873364403f9)
1c2ed51d1SGreg Roach<?php
2c2ed51d1SGreg Roach
3c2ed51d1SGreg Roach/**
4c2ed51d1SGreg Roach * webtrees: online genealogy
5*d11be702SGreg Roach * Copyright (C) 2023 webtrees development team
6c2ed51d1SGreg Roach * This program is free software: you can redistribute it and/or modify
7c2ed51d1SGreg Roach * it under the terms of the GNU General Public License as published by
8c2ed51d1SGreg Roach * the Free Software Foundation, either version 3 of the License, or
9c2ed51d1SGreg Roach * (at your option) any later version.
10c2ed51d1SGreg Roach * This program is distributed in the hope that it will be useful,
11c2ed51d1SGreg Roach * but WITHOUT ANY WARRANTY; without even the implied warranty of
12c2ed51d1SGreg Roach * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13c2ed51d1SGreg Roach * GNU General Public License for more details.
14c2ed51d1SGreg Roach * You should have received a copy of the GNU General Public License
15c2ed51d1SGreg Roach * along with this program. If not, see <https://www.gnu.org/licenses/>.
16c2ed51d1SGreg Roach */
17c2ed51d1SGreg Roach
18c2ed51d1SGreg Roachdeclare(strict_types=1);
19c2ed51d1SGreg Roach
20c2ed51d1SGreg Roachnamespace Fisharebest\Webtrees\Contracts;
21c2ed51d1SGreg Roach
22c2ed51d1SGreg Roach/**
23c2ed51d1SGreg Roach * Make a GEDCOM primitive element.
24c2ed51d1SGreg Roach */
25c2ed51d1SGreg Roachinterface ElementFactoryInterface
26c2ed51d1SGreg Roach{
27c2ed51d1SGreg Roach    /**
28c2ed51d1SGreg Roach     * Create a GEDCOM primitive object.
29c2ed51d1SGreg Roach     *
30c2ed51d1SGreg Roach     * @param string $tag
31c2ed51d1SGreg Roach     *
32c2ed51d1SGreg Roach     * @return ElementInterface
33c2ed51d1SGreg Roach     */
34c2ed51d1SGreg Roach    public function make(string $tag): ElementInterface;
35c2ed51d1SGreg Roach
36c2ed51d1SGreg Roach    /**
3700c92694SGreg Roach     * Register GEDCOM tags.
38c2ed51d1SGreg Roach     *
39c2ed51d1SGreg Roach     * @param array<string,ElementInterface> $elements
40c2ed51d1SGreg Roach     */
4100c92694SGreg Roach    public function registerTags(array $elements): void;
4200c92694SGreg Roach
4300c92694SGreg Roach    /**
4400c92694SGreg Roach     * Register more subtags.
4500c92694SGreg Roach     *
4600c92694SGreg Roach     * @param array<string,array<int,array<int,string>>> $subtags
4700c92694SGreg Roach     */
4800c92694SGreg Roach    public function registerSubTags(array $subtags): void;
49c2ed51d1SGreg Roach}
50