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