21344532034

Committed 26 Jan 2026 02:43AM UTC coverage: 91.98% (-0.4%) from 92.376%

Build # 21344532034

Build Type

push

github

Committed by

Commit Message

added CLAUDE.md

Run Details

2397 of 2606 relevant lines covered (91.98%)

0.92 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

92.45

/src/Texy/Modules/FigureModule.php

<?php

/**
 * This file is part of the Texy! (https://texy.nette.org)
 * Copyright (c) 2004 David Grudl (https://davidgrudl.com)
 */

declare(strict_types=1);

namespace Texy\Modules;

use Texy;
use Texy\Patterns;
use function trim;


/**
 * Processes images with captions.
 */
final class FigureModule extends Texy\Module
{
        public string $tagName = 'div';

        /** non-floated box CSS class */
        public ?string $class = 'figure';

        /** left-floated box CSS class */
        public ?string $leftClass = null;

        /** right-floated box CSS class */
        public ?string $rightClass = null;

        /** how calculate div's width */
        public int|false $widthDelta = 10;

        /** caption after *** is required */
        public bool $requireCaption = true;


        public function __construct(Texy\Texy $texy)
        {
                $this->texy = $texy;
                $texy->addHandler('figure', $this->solve(...));
                $texy->addHandler('beforeParse', $this->beforeParse(...));
        }


        private function beforeParse(): void
        {
                $this->texy->registerBlockPattern(
                        $this->pattern(...),
                        '#^(?>\[\*\ *+([^\n' . Patterns::MARK . ']{1,1000})' . Patterns::MODIFIER . '?\ *+(\*|(?<!<)>|<)\])' // [* urls .(title)[class]{style} >]
                        . '(?::(' . Patterns::LINK_URL . '|:))??'
                        . '(?:\ ++\*\*\*\ ++(.{0,2000}))' . ($this->requireCaption ? '' : '?')
                        . Patterns::MODIFIER_H . '?()$#mUu',
                        'figure',
                );
        }


        /**
         * Callback for [*image*]:link *** .... .(title)[class]{style}>.
         * @param  string[]  $matches
         */
        public function pattern(Texy\BlockParser $parser, array $matches): Texy\HtmlElement|string|null
        {
                [, $mURLs, $mImgMod, $mAlign, $mLink, $mContent, $mMod] = $matches;
                // [1] => URLs
                // [2] => .(title)[class]{style}<>
                // [3] => * < >
                // [4] => url | [ref] | [*image*]
                // [5] => ...
                // [6] => .(title)[class]{style}<>

                $texy = $this->texy;
                $image = $texy->imageModule->factoryImage($mURLs, $mImgMod . $mAlign);
                $mod = new Texy\Modifier($mMod);
                $mContent = trim($mContent);

                if ($mLink) {
                        if ($mLink === ':') {
                                $link = new Texy\Link($image->linkedURL ?? $image->URL);
                                $link->raw = ':';
                                $link->type = $link::IMAGE;
                        } else {
                                $link = $texy->linkModule->factoryLink($mLink, null, null);
                        }
                } else {
                        $link = null;
                }

                return $texy->invokeAroundHandlers('figure', $parser, [$image, $link, $mContent, $mod]);
        }


        /**
         * Finish invocation.
         */
        private function solve(
                Texy\HandlerInvocation $invocation,
                Texy\Image $image,
                ?Texy\Link $link,
                string $content,
                Texy\Modifier $mod,
        ): ?Texy\HtmlElement
        {
                $texy = $this->texy;

                $hAlign = $image->modifier->hAlign;
                $image->modifier->hAlign = null;

                $elImg = $texy->imageModule->solve(null, $image, $link); // returns Texy\HtmlElement or null!
                if (!$elImg) {
                        return null;
                }

                $el = new Texy\HtmlElement($this->tagName);
                if (!empty($image->width) && $this->widthDelta !== false) {
                        $el->attrs['style'] = (array) ($el->attrs['style'] ?? []);
                        $el->attrs['style']['max-width'] = ($image->width + $this->widthDelta) . 'px';
                }

                $mod->decorate($texy, $el);

                $el->add($elImg);

                if ($content !== '') {
                        $el[1] = new Texy\HtmlElement($this->tagName === 'figure' ? 'figcaption' : 'p');
                        $el[1]->parseLine($texy, $content);
                }

                $class = $this->class;
                if ($hAlign) {
                        $var = $hAlign . 'Class'; // leftClass, rightClass
                        if (!empty($this->$var)) {
                                $class = $this->$var;

                        } elseif (empty($texy->alignClasses[$hAlign])) {
                                $el->attrs['style'] = (array) ($el->attrs['style'] ?? []);
                                $el->attrs['style']['float'] = $hAlign;

                        } else {
                                $class .= '-' . $texy->alignClasses[$hAlign];
                        }
                }

                $el->attrs['class'] = (array) ($el->attrs['class'] ?? []);
                $el->attrs['class'][] = $class;

                return $el;
        }
}

1	<?php
2
3	/**
4	* This file is part of the Texy! (https://texy.nette.org)
5	* Copyright (c) 2004 David Grudl (https://davidgrudl.com)
6	*/
7
8	declare(strict_types=1);
9
10	namespace Texy\Modules;
11
12	use Texy;
13	use Texy\Patterns;
14	use function trim;
15
16
17	/**
18	* Processes images with captions.
19	*/
20	final class FigureModule extends Texy\Module
21	{
22	public string $tagName = 'div';
23
24	/** non-floated box CSS class */
25	public ?string $class = 'figure';
26
27	/** left-floated box CSS class */
28	public ?string $leftClass = null;
29
30	/** right-floated box CSS class */
31	public ?string $rightClass = null;
32
33	/** how calculate div's width */
34	public int\|false $widthDelta = 10;
35
36	/ caption after * is required */
37	public bool $requireCaption = true;
38
39
40	public function __construct(Texy\Texy $texy)	1✔
41	{
42	$this->texy = $texy;	1✔
43	$texy->addHandler('figure', $this->solve(...));	1✔
44	$texy->addHandler('beforeParse', $this->beforeParse(...));	1✔
45	}	1✔
46
47
48	private function beforeParse(): void
49	{
50	$this->texy->registerBlockPattern(	1✔
51	$this->pattern(...),	1✔
52	'#^(?>\[\\ +([^\n' . Patterns::MARK . ']{1,1000})' . Patterns::MODIFIER . '?\ +(\\|(?<!<)>\|<)\])' // [* urls .(title)[class]{style} >]
53	. '(?::(' . Patterns::LINK_URL . '\|:))??'
54	. '(?:\ ++\\\*\ ++(.{0,2000}))' . ($this->requireCaption ? '' : '?')	1✔
55	. Patterns::MODIFIER_H . '?()$#mUu',	1✔
56	'figure',	1✔
57	);
58	}	1✔
59
60
61	/**
62	* Callback for [image]:link *** .... .(title)[class]{style}>.
63	* @param string[] $matches
64	*/
65	public function pattern(Texy\BlockParser $parser, array $matches): Texy\HtmlElement\|string\|null	1✔
66	{
67	[, $mURLs, $mImgMod, $mAlign, $mLink, $mContent, $mMod] = $matches;	1✔
68	// [1] => URLs
69	// [2] => .(title)[class]{style}<>
70	// [3] => * < >
71	// [4] => url \| [ref] \| [image]
72	// [5] => ...
73	// [6] => .(title)[class]{style}<>
74
75	$texy = $this->texy;	1✔
76	$image = $texy->imageModule->factoryImage($mURLs, $mImgMod . $mAlign);	1✔
77	$mod = new Texy\Modifier($mMod);	1✔
78	$mContent = trim($mContent);	1✔
79
80	if ($mLink) {	1✔
81	if ($mLink === ':') {	1✔
82	$link = new Texy\Link($image->linkedURL ?? $image->URL);	1✔
83	$link->raw = ':';	1✔
84	$link->type = $link::IMAGE;	1✔
85	} else {
86	$link = $texy->linkModule->factoryLink($mLink, null, null);	1✔
87	}
88	} else {
89	$link = null;	1✔
90	}
91
92	return $texy->invokeAroundHandlers('figure', $parser, [$image, $link, $mContent, $mod]);	1✔
93	}
94
95
96	/**
97	* Finish invocation.
98	*/
99	private function solve(	1✔
100	Texy\HandlerInvocation $invocation,
101	Texy\Image $image,
102	?Texy\Link $link,
103	string $content,
104	Texy\Modifier $mod,
105	): ?Texy\HtmlElement
106	{
107	$texy = $this->texy;	1✔
108
109	$hAlign = $image->modifier->hAlign;	1✔
110	$image->modifier->hAlign = null;	1✔
111
112	$elImg = $texy->imageModule->solve(null, $image, $link); // returns Texy\HtmlElement or null!	1✔
113	if (!$elImg) {	1✔
114	return null;	×
115	}
116
117	$el = new Texy\HtmlElement($this->tagName);	1✔
118	if (!empty($image->width) && $this->widthDelta !== false) {	1✔
119	$el->attrs['style'] = (array) ($el->attrs['style'] ?? []);	×
120	$el->attrs['style']['max-width'] = ($image->width + $this->widthDelta) . 'px';	×
121	}
122
123	$mod->decorate($texy, $el);	1✔
124
125	$el->add($elImg);	1✔
126
127	if ($content !== '') {	1✔
128	$el[1] = new Texy\HtmlElement($this->tagName === 'figure' ? 'figcaption' : 'p');	1✔
129	$el[1]->parseLine($texy, $content);	1✔
130	}
131
132	$class = $this->class;	1✔
133	if ($hAlign) {	1✔
134	$var = $hAlign . 'Class'; // leftClass, rightClass	1✔
135	if (!empty($this->$var)) {	1✔
136	$class = $this->$var;	1✔
137
138	} elseif (empty($texy->alignClasses[$hAlign])) {	1✔
139	$el->attrs['style'] = (array) ($el->attrs['style'] ?? []);	1✔
140	$el->attrs['style']['float'] = $hAlign;	1✔
141
142	} else {
143	$class .= '-' . $texy->alignClasses[$hAlign];	×
144	}
145	}
146
147	$el->attrs['class'] = (array) ($el->attrs['class'] ?? []);	1✔
148	$el->attrs['class'][] = $class;	1✔
149
150	return $el;	1✔
151	}
152	}

dg / texy / 21344532034

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous