<?php

// Copyright (C) 2010-2026, the Friendica project
// SPDX-FileCopyrightText: 2010-2026 the Friendica project
//
// SPDX-License-Identifier: AGPL-3.0-or-later

declare(strict_types=1);

namespace Friendica\Core;

use Dice\Dice;

/**
 * Wrapper for the Dice class to make some basic setups
 *
 * @internal
 */
final class DiceContainer implements Container
{
	public static function fromBasePath(string $basePath): self
	{
		$path = $basePath . '/static/dependencies.config.php';

		$dice = (new Dice())->addRules(require($path));

		return new self($dice);
	}

	private function __construct(private Dice $container) {}

	/**
	 * Returns a fully constructed object based on $name using $args and $share as constructor arguments if supplied
	 * @param string $name  name The name of the class to instantiate
	 * @param array  $args  An array with any additional arguments to be passed into the constructor upon instantiation
	 * @param array  $share a list of defined in shareInstances for objects higher up the object graph, should only be used internally
	 * @return object A fully constructed object based on the specified input arguments
	 *
	 * @see Dice::create()
	 */
	public function create(string $name, array $args = [], array $share = []): object
	{
		return $this->container->create($name, $args, $share);
	}

	/**
	 * Add a rule $rule to the class $name
	 * @param string $name The name of the class to add the rule for
	 * @param array  $rule The container can be fully configured using rules provided by associative arrays. See {@link https://r.je/dice.html#example3} for a description of the rules.
	 *
	 * @see Dice::addRule()
	 */
	public function addRule(string $name, array $rule): void
	{
		$this->container = $this->container->addRule($name, $rule);
	}

	/**
	 * Only used to inject Dice into DI class
	 *
	 * @see \Friendica\DI
	 *
	 * @internal
	 *
	 * @deprecated
	 */
	public function getDice(): Dice
	{
		return $this->container;
	}
}
