.
*/
declare(strict_types=1);
namespace Fisharebest\Webtrees\Services;
use Fisharebest\Webtrees\Gedcom;
use Fisharebest\Webtrees\Registry;
use Fisharebest\Webtrees\Tree;
use Psr\Http\Message\ServerRequestInterface;
use function array_merge;
use function array_unique;
use function assert;
use function count;
use function preg_match_all;
use function str_replace;
use function trim;
/**
* Utilities to edit/save GEDCOM data.
*/
class GedcomEditService
{
/** @var string[] */
public $glevels = [];
/** @var string[] */
public $tag = [];
/** @var string[] */
public $islink = [];
/** @var string[] */
public $text = [];
/** @var string[] */
protected $glevelsSOUR = [];
/** @var string[] */
protected $tagSOUR = [];
/** @var string[] */
protected $islinkSOUR = [];
/** @var string[] */
protected $textSOUR = [];
/** @var string[] */
protected $glevelsRest = [];
/** @var string[] */
protected $tagRest = [];
/** @var string[] */
protected $islinkRest = [];
/** @var string[] */
protected $textRest = [];
/**
* This function splits the $glevels, $tag, $islink, and $text arrays so that the
* entries associated with a SOUR record are separate from everything else.
*
* Input arrays:
* - $glevels[] - an array of the gedcom level for each line that was edited
* - $tag[] - an array of the tags for each gedcom line that was edited
* - $islink[] - an array of 1 or 0 values to indicate when the text is a link element
* - $text[] - an array of the text data for each line
*
* Output arrays:
* ** For the SOUR record:
* - $glevelsSOUR[] - an array of the gedcom level for each line that was edited
* - $tagSOUR[] - an array of the tags for each gedcom line that was edited
* - $islinkSOUR[] - an array of 1 or 0 values to indicate when the text is a link element
* - $textSOUR[] - an array of the text data for each line
* ** For the remaining records:
* - $glevelsRest[] - an array of the gedcom level for each line that was edited
* - $tagRest[] - an array of the tags for each gedcom line that was edited
* - $islinkRest[] - an array of 1 or 0 values to indicate when the text is a link element
* - $textRest[] - an array of the text data for each line
*
* @return void
*/
public function splitSource(): void
{
$this->glevelsSOUR = [];
$this->tagSOUR = [];
$this->islinkSOUR = [];
$this->textSOUR = [];
$this->glevelsRest = [];
$this->tagRest = [];
$this->islinkRest = [];
$this->textRest = [];
$inSOUR = false;
$levelSOUR = 0;
// Assume all arrays are the same size.
$count = count($this->glevels);
for ($i = 0; $i < $count; $i++) {
if ($inSOUR) {
if ($levelSOUR < $this->glevels[$i]) {
$dest = 'S';
} else {
$inSOUR = false;
$dest = 'R';
}
} elseif ($this->tag[$i] === 'SOUR') {
$inSOUR = true;
$levelSOUR = $this->glevels[$i];
$dest = 'S';
} else {
$dest = 'R';
}
if ($dest === 'S') {
$this->glevelsSOUR[] = $this->glevels[$i];
$this->tagSOUR[] = $this->tag[$i];
$this->islinkSOUR[] = $this->islink[$i];
$this->textSOUR[] = $this->text[$i];
} else {
$this->glevelsRest[] = $this->glevels[$i];
$this->tagRest[] = $this->tag[$i];
$this->islinkRest[] = $this->islink[$i];
$this->textRest[] = $this->text[$i];
}
}
}
/**
* Add new GEDCOM lines from the $xxxRest interface update arrays, which
* were produced by the splitSOUR() function.
* See the FunctionsEdit::handle_updatesges() function for details.
*
* @param string $inputRec
*
* @return string
*/
public function updateRest(string $inputRec): string
{
if (count($this->tagRest) === 0) {
return $inputRec; // No update required
}
// Save original interface update arrays before replacing them with the xxxRest ones
$glevelsSave = $this->glevels;
$tagSave = $this->tag;
$islinkSave = $this->islink;
$textSave = $this->text;
$this->glevels = $this->glevelsRest;
$this->tag = $this->tagRest;
$this->islink = $this->islinkRest;
$this->text = $this->textRest;
$myRecord = $this->handleUpdates($inputRec, 'no'); // Now do the update
// Restore the original interface update arrays (just in case ...)
$this->glevels = $glevelsSave;
$this->tag = $tagSave;
$this->islink = $islinkSave;
$this->text = $textSave;
return $myRecord;
}
/**
* Add new gedcom lines from interface update arrays
* The edit_interface and FunctionsEdit::add_simple_tag function produce the following
* arrays incoming from the $_POST form
* - $glevels[] - an array of the gedcom level for each line that was edited
* - $tag[] - an array of the tags for each gedcom line that was edited
* - $islink[] - an array of 1 or 0 values to tell whether the text is a link element and should be surrounded by @@
* - $text[] - an array of the text data for each line
* With these arrays you can recreate the gedcom lines like this
* $glevel[0].' '.$tag[0].' '.$text[0]
* There will be an index in each of these arrays for each line of the gedcom
* fact that is being edited.
* If the $text[] array is empty for the given line, then it means that the
* user removed that line during editing or that the line is supposed to be
* empty (1 DEAT, 1 BIRT) for example. To know if the line should be removed
* there is a section of code that looks ahead to the next lines to see if there
* are sub lines. For example we don't want to remove the 1 DEAT line if it has
* a 2 PLAC or 2 DATE line following it. If there are no sub lines, then the line
* can be safely removed.
*
* @param string $newged the new gedcom record to add the lines to
* @param string $levelOverride Override GEDCOM level specified in $glevels[0]
*
* @return string The updated gedcom record
*/
public function handleUpdates(string $newged, $levelOverride = 'no'): string
{
if ($levelOverride === 'no') {
$levelAdjust = 0;
} else {
$levelAdjust = 1;
}
// Assert all arrays are the same size.
assert(count($this->glevels) === count($this->tag));
assert(count($this->glevels) === count($this->text));
assert(count($this->glevels) === count($this->islink));
$count = count($this->glevels);
for ($j = 0; $j < $count; $j++) {
// Look for empty SOUR reference with non-empty sub-records.
// This can happen when the SOUR entry is deleted but its sub-records
// were incorrectly left intact.
// The sub-records should be deleted.
if ($this->tag[$j] === 'SOUR' && ($this->text[$j] === '@@' || $this->text[$j] === '')) {
$this->text[$j] = '';
$k = $j + 1;
while ($k < $count && $this->glevels[$k] > $this->glevels[$j]) {
$this->text[$k] = '';
$k++;
}
}
if (trim($this->text[$j]) !== '') {
$pass = true;
} else {
//-- for facts with empty values they must have sub records
//-- this section checks if they have subrecords
$k = $j + 1;
$pass = false;
while ($k < $count && $this->glevels[$k] > $this->glevels[$j]) {
if ($this->text[$k] !== '') {
if ($this->tag[$j] !== 'OBJE' || $this->tag[$k] === 'FILE') {
$pass = true;
break;
}
}
$k++;
}
}
//-- if the value is not empty or it has sub lines
//--- then write the line to the gedcom record
//-- we have to let some emtpy text lines pass through... (DEAT, BIRT, etc)
if ($pass) {
$newline = (int) $this->glevels[$j] + $levelAdjust . ' ' . $this->tag[$j];
if ($this->text[$j] !== '') {
if ($this->islink[$j]) {
$newline .= ' @' . $this->text[$j] . '@';
} else {
$newline .= ' ' . $this->text[$j];
}
}
$next_level = 1 + (int) $this->glevels[$j] + $levelAdjust;
$newged .= "\n" . str_replace("\n", "\n" . $next_level . ' CONT ', $newline);
}
}
return $newged;
}
/**
* Create a form to add a new fact.
*
* @param ServerRequestInterface $request
* @param Tree $tree
* @param string $fact
*
* @return string
*/
public function addNewFact(ServerRequestInterface $request, Tree $tree, string $fact): string
{
$params = (array) $request->getParsedBody();
$FACT = $params[$fact];
$DATE = $params[$fact . '_DATE'] ?? '';
$PLAC = $params[$fact . '_PLAC'] ?? '';
if ($DATE !== '' || $PLAC !== '' || $FACT !== '' && $FACT !== 'Y') {
if ($FACT !== '' && $FACT !== 'Y') {
$gedrec = "\n1 " . $fact . ' ' . $FACT;
} else {
$gedrec = "\n1 " . $fact;
}
if ($DATE !== '') {
$gedrec .= "\n2 DATE " . $DATE;
}
if ($PLAC !== '') {
$gedrec .= "\n2 PLAC " . $PLAC;
if (preg_match_all('/(' . Gedcom::REGEX_TAG . ')/', $tree->getPreference('ADVANCED_PLAC_FACTS'), $match)) {
foreach ($match[1] as $tag) {
$TAG = $params[$fact . '_' . $tag];
if ($TAG !== '') {
$gedrec .= "\n3 " . $tag . ' ' . $TAG;
}
}
}
$LATI = $params[$fact . '_LATI'] ?? '';
$LONG = $params[$fact . '_LONG'] ?? '';
if ($LATI !== '' || $LONG !== '') {
$gedrec .= "\n3 MAP\n4 LATI " . $LATI . "\n4 LONG " . $LONG;
}
}
if ((bool) ($params['SOUR_' . $fact] ?? false)) {
return $this->updateSource($gedrec, 'yes');
}
return $gedrec;
}
if ($FACT === 'Y') {
if ((bool) ($params['SOUR_' . $fact] ?? false)) {
return $this->updateSource("\n1 " . $fact . ' Y', 'yes');
}
return "\n1 " . $fact . ' Y';
}
return '';
}
/**
* Add new GEDCOM lines from the $xxxSOUR interface update arrays, which
* were produced by the splitSOUR() function.
* See the FunctionsEdit::handle_updatesges() function for details.
*
* @param string $inputRec
* @param string $levelOverride
*
* @return string
*/
public function updateSource(string $inputRec, string $levelOverride = 'no'): string
{
if (count($this->tagSOUR) === 0) {
return $inputRec; // No update required
}
// Save original interface update arrays before replacing them with the xxxSOUR ones
$glevelsSave = $this->glevels;
$tagSave = $this->tag;
$islinkSave = $this->islink;
$textSave = $this->text;
$this->glevels = $this->glevelsSOUR;
$this->tag = $this->tagSOUR;
$this->islink = $this->islinkSOUR;
$this->text = $this->textSOUR;
$myRecord = $this->handleUpdates($inputRec, $levelOverride); // Now do the update
// Restore the original interface update arrays (just in case ...)
$this->glevels = $glevelsSave;
$this->tag = $tagSave;
$this->islink = $islinkSave;
$this->text = $textSave;
return $myRecord;
}
/**
* Create a form to add a sex record.
*
* @param ServerRequestInterface $request
*
* @return string
*/
public function addNewSex(ServerRequestInterface $request): string
{
$params = (array) $request->getParsedBody();
switch ($params['SEX']) {
case 'M':
return "\n1 SEX M";
case 'F':
return "\n1 SEX F";
default:
return "\n1 SEX U";
}
}
/**
* Assemble the pieces of a newly created record into gedcom
*
* @param ServerRequestInterface $request
* @param Tree $tree
*
* @return string
*/
public function addNewName(ServerRequestInterface $request, Tree $tree): string
{
$params = (array) $request->getParsedBody();
$gedrec = "\n1 NAME " . $params['NAME'];
$tags = [
'NPFX',
'GIVN',
'SPFX',
'SURN',
'NSFX',
'NICK',
];
if (preg_match_all('/(' . Gedcom::REGEX_TAG . ')/', $tree->getPreference('ADVANCED_NAME_FACTS'), $match)) {
$tags = array_merge($tags, $match[1]);
}
// Paternal and Polish and Lithuanian surname traditions can also create a _MARNM
$SURNAME_TRADITION = $tree->getPreference('SURNAME_TRADITION');
if ($SURNAME_TRADITION === 'paternal' || $SURNAME_TRADITION === 'polish' || $SURNAME_TRADITION === 'lithuanian') {
$tags[] = '_MARNM';
}
foreach (array_unique($tags) as $tag) {
$TAG = $params[$tag];
if ($TAG !== '') {
$gedrec .= "\n2 " . $tag . ' ' . $TAG;
}
}
return $gedrec;
}
/**
* Reassemble edited GEDCOM fields into a GEDCOM fact/event string.
*
* @param string $record_type
* @param array $levels
* @param array $tags
* @param array $values
*
* @return string
*/
public function editLinesToGedcom(string $record_type, array $levels, array $tags, array $values): string
{
// Assert all arrays are the same size.
$count = count($levels);
assert($count > 0);
assert(count($tags) === $count);
assert(count($values) === $count);
$gedcom_lines = [];
$hierarchy = [$record_type];
for ($i = 0; $i < $count; $i++) {
$hierarchy[$levels[$i]] = $tags[$i];
$full_tag = implode(':', array_slice($hierarchy, 0, 1 + (int) $levels[$i]));
$element = Registry::elementFactory()->make($full_tag);
$values[$i] = $element->canonical($values[$i]);
// If "1 FACT Y" has a DATE or PLAC, then delete the value of Y
if ($levels[$i] === '1' && $values[$i] === 'Y') {
for ($j = $i + 1; $j < $count && $levels[$j] > $levels[$i]; ++$j) {
if ($levels[$j] === '2' && ($tags[$j] === 'DATE' || $tags[$j] === 'PLAC') && $values[$j] !== '') {
$values[$i] = '';
break;
}
}
}
// Include this line if there is a value - or if there is a child record with a value.
$include = $values[$i] !== '';
for ($j = $i + 1; !$include && $j < $count && $levels[$j] > $levels[$i]; $j++) {
$include = $values[$j] !== '';
}
if ($include) {
if ($values[$i] === '') {
$gedcom_lines[] = $levels[$i] . ' ' . $tags[$i];
} else {
$next_level = 1 + (int) $levels[$i];
$gedcom_lines[] = $levels[$i] . ' ' . $tags[$i] . ' ' . str_replace("\n", "\n" . $next_level . ' CONT ', $values[$i]);
}
}
}
return implode("\n", $gedcom_lines);
}
}