ofco/chaffe-theme
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

added in vendor for prod

Browse Source
This commit is contained in:
Kurtis Holsapple
2025-05-06 08:24:59 -07:00
parent 6207303b1c
commit db52cd6933
91 changed files with 13191 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

733
vendor/salesforce/handlebars-php/src/Handlebars/Helpers.php vendored Executable file
View File

@@ -0,0 +1,733 @@
<?php
/**
* Helpers
*
* a collection of helper function. normally a function like
* function ($sender, $name, $arguments) $arguments is unscaped arguments and
* is a string, not array
*
* @category Xamin
* @package Handlebars
* @author fzerorubigd <fzerorubigd@gmail.com>
* @author Behrooz Shabani <everplays@gmail.com>
* @author Mardix <https://github.com/mardix>
* @copyright 2012 (c) ParsPooyesh Co
* @copyright 2013 (c) Behrooz Shabani
* @copyright 2014 (c) Mardix
* @license MIT
* @link http://voodoophp.org/docs/handlebars
*/
namespace Handlebars;
use DateTime;
use InvalidArgumentException;
use Traversable;
use LogicException;
class Helpers
{
/**
* @var array array of helpers
*/
protected $helpers = [];
private $tpl = [];
protected $builtinHelpers = [
"if",
"each",
"with",
"unless",
"bindAttr",
"upper", // Put all chars in uppercase
"lower", // Put all chars in lowercase
"capitalize", // Capitalize just the first word
"capitalize_words", // Capitalize each words
"reverse", // Reverse a string
"format_date", // Format a date
"inflect", // Inflect the wording based on count ie. 1 album, 10 albums
"default", // If a variable is null, it will use the default instead
"truncate", // Truncate section
"raw", // Return the source as is without converting
"repeat", // Repeat a section
"define", // Define a block to be used using "invoke"
"invoke", // Invoke a block that was defined with "define"
];
/**
* Create new helper container class
*
* @param array $helpers array of name=>$value helpers
* @throws \InvalidArgumentException when $helpers is not an array
* (or traversable) or helper is not a callable
*/
public function __construct($helpers = null)
{
foreach($this->builtinHelpers as $helper) {
$helperName = $this->underscoreToCamelCase($helper);
$this->add($helper, [$this, "helper{$helperName}"]);
}
if ($helpers != null) {
if (!is_array($helpers) && !$helpers instanceof Traversable) {
throw new InvalidArgumentException(
'HelperCollection constructor expects an array of helpers'
);
}
foreach ($helpers as $name => $helper) {
$this->add($name, $helper);
}
}
}
/**
* Add a new helper to helpers
*
* @param string $name helper name
* @param callable $helper a function as a helper
*
* @throws \InvalidArgumentException if $helper is not a callable
* @return void
*/
public function add($name, $helper)
{
if (!is_callable($helper)) {
throw new InvalidArgumentException("$name Helper is not a callable.");
}
$this->helpers[$name] = $helper;
}
/**
* Check if $name helper is available
*
* @param string $name helper name
*
* @return boolean
*/
public function has($name)
{
return array_key_exists($name, $this->helpers);
}
/**
* Get a helper. __magic__ method :)
*
* @param string $name helper name
*
* @throws \InvalidArgumentException if $name is not available
* @return callable helper function
*/
public function __get($name)
{
if (!$this->has($name)) {
throw new InvalidArgumentException('Unknown helper :' . $name);
}
return $this->helpers[$name];
}
/**
* Check if $name helper is available __magic__ method :)
*
* @param string $name helper name
*
* @return boolean
* @see Handlebras_Helpers::has
*/
public function __isset($name)
{
return $this->has($name);
}
/**
* Add a new helper to helpers __magic__ method :)
*
* @param string $name helper name
* @param callable $helper a function as a helper
*
* @return void
*/
public function __set($name, $helper)
{
$this->add($name, $helper);
}
/**
* Unset a helper
*
* @param string $name helper name to remove
* @return void
*/
public function __unset($name)
{
unset($this->helpers[$name]);
}
/**
* Check whether a given helper is present in the collection.
*
* @param string $name helper name
* @throws \InvalidArgumentException if the requested helper is not present.
* @return void
*/
public function remove($name)
{
if (!$this->has($name)) {
throw new InvalidArgumentException('Unknown helper: ' . $name);
}
unset($this->helpers[$name]);
}
/**
* Clear the helper collection.
*
* Removes all helpers from this collection
*
* @return void
*/
public function clear()
{
$this->helpers = [];
}
/**
* Check whether the helper collection is empty.
*
* @return boolean True if the collection is empty
*/
public function isEmpty()
{
return empty($this->helpers);
}
/**
* Create handler for the 'if' helper.
*
* {{#if condition}}
* Something here
* {{else}}
* something else here
* {{/if}}
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return mixed
*/
public function helperIf($template, $context, $args, $source)
{
$tmp = $context->get($args);
if ($tmp) {
$template->setStopToken('else');
$buffer = $template->render($context);
$template->setStopToken(false);
$template->discard();
return $buffer;
} else {
return $this->renderElse($template, $context);
}
}
/**
* Create handler for the 'each' helper.
* example {{#each people}} {{name}} {{/each}}
* example with slice: {{#each people[0:10]}} {{name}} {{/each}}
* example with else
* {{#each Array}}
* {{.}}
* {{else}}
* Nothing found
* {{/each}}
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return mixed
*/
public function helperEach($template, $context, $args, $source)
{
list($keyname, $slice_start, $slice_end) = $this->extractSlice($args);
$tmp = $context->get($keyname);
if (is_array($tmp) || $tmp instanceof Traversable) {
$tmp = array_slice($tmp, $slice_start, $slice_end);
$buffer = '';
$islist = array_values($tmp) === $tmp;
if (is_array($tmp) && ! count($tmp)) {
return $this->renderElse($template, $context);
} else {
$itemCount = -1;
if ($islist) {
$itemCount = count($tmp);
}
foreach ($tmp as $key => $var) {
$tpl = clone $template;
if ($islist) {
$context->pushIndex($key);
// If data variables are enabled, push the data related to this #each context
if ($template->getEngine()->isDataVariablesEnabled()) {
$context->pushData([
Context::DATA_KEY => $key,
Context::DATA_INDEX => $key,
Context::DATA_LAST => $key == ($itemCount - 1),
Context::DATA_FIRST => $key == 0,
]);
}
} else {
$context->pushKey($key);
// If data variables are enabled, push the data related to this #each context
if ($template->getEngine()->isDataVariablesEnabled()) {
$context->pushData([
Context::DATA_KEY => $key,
]);
}
}
$context->push($var);
$tpl->setStopToken('else');
$buffer .= $tpl->render($context);
$context->pop();
if ($islist) {
$context->popIndex();
} else {
$context->popKey();
}
if ($template->getEngine()->isDataVariablesEnabled()) {
$context->popData();
}
}
return $buffer;
}
} else {
return $this->renderElse($template, $context);
}
}
/**
* Applying the DRY principle here.
* This method help us render {{else}} portion of a block
* @param \Handlebars\Template $template
* @param \Handlebars\Context $context
* @return string
*/
private function renderElse($template, $context)
{
$template->setStopToken('else');
$template->discard();
$template->setStopToken(false);
return $template->render($context);
}
/**
* Create handler for the 'unless' helper.
* {{#unless condition}}
* Something here
* {{else}}
* something else here
* {{/unless}}
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return mixed
*/
public function helperUnless($template, $context, $args, $source)
{
$tmp = $context->get($args);
if (!$tmp) {
$template->setStopToken('else');
$buffer = $template->render($context);
$template->setStopToken(false);
$template->discard();
return $buffer;
} else {
return $this->renderElse($template, $context);
}
}
/**
* Create handler for the 'with' helper.
* Needed for compatibility with PHP 5.2 since it doesn't support anonymous
* functions.
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return mixed
*/
public function helperWith($template, $context, $args, $source)
{
$tmp = $context->get($args);
$context->push($tmp);
$buffer = $template->render($context);
$context->pop();
return $buffer;
}
/**
* Create handler for the 'bindAttr' helper.
* Needed for compatibility with PHP 5.2 since it doesn't support anonymous
* functions.
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return mixed
*/
public function helperBindAttr($template, $context, $args, $source)
{
return $args;
}
/**
* To uppercase string
*
* {{#upper data}}
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return string
*/
public function helperUpper($template, $context, $args, $source)
{
return strtoupper($context->get($args));
}
/**
* To lowercase string
*
* {{#lower data}}
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return string
*/
public function helperLower($template, $context, $args, $source)
{
return strtolower($context->get($args));
}
/**
* to capitalize first letter
*
* {{#capitalize}}
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return string
*/
public function helperCapitalize($template, $context, $args, $source)
{
return ucfirst($context->get($args));
}
/**
* To capitalize first letter in each word
*
* {{#capitalize_words data}}
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return string
*/
public function helperCapitalizeWords($template, $context, $args, $source)
{
return ucwords($context->get($args));
}
/**
* To reverse a string
*
* {{#reverse data}}
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return string
*/
public function helperReverse($template, $context, $args, $source)
{
return strrev($context->get($args));
}
/**
* Format a date
*
* {{#format_date date 'Y-m-d @h:i:s'}}
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return mixed
*/
public function helperFormatDate($template, $context, $args, $source)
{
preg_match("/(.*?)\s+(?:(?:\"|\')(.*?)(?:\"|\'))/", $args, $m);
$keyname = $m[1];
$format = $m[2];
$date = $context->get($keyname);
if ($format) {
$dt = new DateTime;
if (is_numeric($date)) {
$dt = (new DateTime)->setTimestamp($date);
} else {
$dt = new DateTime($date);
}
return $dt->format($format);
} else {
return $date;
}
}
/**
* {{inflect count 'album' 'albums'}}
* {{inflect count '%d album' '%d albums'}}
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return mixed
*/
public function helperInflect($template, $context, $args, $source)
{
preg_match("/(.*?)\s+(?:(?:\"|\')(.*?)(?:\"|\'))\s+(?:(?:\"|\')(.*?)(?:\"|\'))/", $args, $m);
$keyname = $m[1];
$singular = $m[2];
$plurial = $m[3];
$value = $context->get($keyname);
$inflect = ($value <= 1) ? $singular : $plurial;
return sprintf($inflect, $value);
}
/**
* Provide a default fallback
*
* {{default title "No title available"}}
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return string
*/
public function helperDefault($template, $context, $args, $source)
{
preg_match("/(.*?)\s+(?:(?:\"|\')(.*?)(?:\"|\'))/", trim($args), $m);
$keyname = $m[1];
$default = $m[2];
$value = $context->get($keyname);
return ($value) ?: $default;
}
/**
* Truncate a string to a length, and append and ellipsis if provided
* {{#truncate content 5 "..."}}
*
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return string
*/
public function helperTruncate($template, $context, $args, $source)
{
preg_match("/(.*?)\s+(.*?)\s+(?:(?:\"|\')(.*?)(?:\"|\'))/", trim($args), $m);
$keyname = $m[1];
$limit = $m[2];
$ellipsis = $m[3];
$value = substr($context->get($keyname), 0, $limit);
if ($ellipsis && strlen($context->get($keyname)) > $limit) {
$value .= $ellipsis;
}
return $value;
}
/**
* Return the data source as is
*
* {{#raw}} {{/raw}}
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return mixed
*/
public function helperRaw($template, $context, $args, $source)
{
return $source;
}
/**
* Repeat section $x times.
*
* {{#repeat 10}}
* This section will be repeated 10 times
* {{/repeat}}
*
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return string
*/
public function helperRepeat($template, $context, $args, $source)
{
$buffer = $template->render($context);
return str_repeat($buffer, intval($args));
}
/**
* Define a section to be used later by using 'invoke'
*
* --> Define a section: hello
* {{#define hello}}
* Hello World!
*
* How is everything?
* {{/define}}
*
* --> This is how it is called
* {{#invoke hello}}
*
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return null
*/
public function helperDefine($template, $context, $args, $source)
{
$this->tpl["DEFINE"][$args] = clone($template);
}
/**
* Invoke a section that was created using 'define'
*
* --> Define a section: hello
* {{#define hello}}
* Hello World!
*
* How is everything?
* {{/define}}
*
* --> This is how it is called
* {{#invoke hello}}
*
*
* @param \Handlebars\Template $template template that is being rendered
* @param \Handlebars\Context $context context object
* @param array $args passed arguments to helper
* @param string $source part of template that is wrapped
* within helper
*
* @return null
*/
public function helperInvoke($template, $context, $args, $source)
{
if (! isset($this->tpl["DEFINE"][$args])) {
throw new LogicException("Can't INVOKE '{$args}'. '{$args}' was not DEFINE ");
}
return $this->tpl["DEFINE"][$args]->render($context);
}
/**
* Change underscore helper name to CamelCase
*
* @param string $string
* @return string
*/
private function underscoreToCamelCase($string)
{
return str_replace(' ', '', ucwords(str_replace('_', ' ', $string)));
}
/**
* slice
* Allow to split the data that will be returned
* #loop[start:end] => starts at start trhough end -1
* #loop[start:] = Starts at start though the rest of the array
* #loop[:end] = Starts at the beginning through end -1
* #loop[:] = A copy of the whole array
*
* #loop[-1]
* #loop[-2:] = Last two items
* #loop[:-2] = Everything except last two items
*
* @param string $string
* @return Array [tag_name, slice_start, slice_end]
*/
private function extractSlice($string)
{
preg_match("/^([\w\._\-]+)(?:\[([\-0-9]*?:[\-0-9]*?)\])?/i", $string, $m);
$slice_start = $slice_end = null;
if (isset($m[2])) {
list($slice_start, $slice_end) = explode(":", $m[2]);
$slice_start = (int) $slice_start;
$slice_end = $slice_end ? (int) $slice_end : null;
}
return [$m[1], $slice_start, $slice_end];
}
}