SettingsStore

El ÚNICO punto de wiring de la store de PRODUCCIÓN de Milpa Admin: tanto el GET (Tarea 6) como el POST (Tarea 7) deben llamar a estos mismos métodos estáticos para garantizar que ambos lean/escriban el MISMO archivo — nunca construyen un {@see SettingsRepository} con su propia ruta calculada aparte, porque cualquier divergencia (aunque sea un carácter) partiría el estado en dos archivos distintos. `SettingsController` (el dueño de la sección Settings, GET/POST en `/milpa/admin/settings` — el Hub en `MilpaAdminController` solo descubre y redirige, nunca toca esta store) se construye en los tests de este plugin vía `new SettingsController($container)` sin bootear `MilpaAdminPlugin` — por eso esta store NO se resuelve vía el contenedor de DI (que además tampoco podría auto-wirear `SettingsRepository`: su constructor toma un `string $file` sin default, un parámetro no-clase que `Milpa\Container\DIContainer::canResolve()` nunca auto-resuelve). Un factory estático llamado directamente por cada controller es el mecanismo que funciona IDÉNTICO en test y en producción, sin depender de que el plugin haya bootstrapeado nada. La ruta cuelga de lo que el host declare por {@see StorageRootSource}: `<raíz>/milpa-admin/settings.json`. El paquete NO la adivina. La versión anterior la calculaba con `dirname(__DIR__, 3)` —contando directorios hacia arriba desde este archivo— y eso funcionaba sólo mientras el código vivía dentro del host: desde un paquete daba `<raíz>/packages/storage/…`, y con `composer require` daba algo dentro de `vendor/`, un directorio que el próximo `composer install` puede borrar entero. Un override por variable de entorno (`MILPA_ADMIN_SETTINGS_PATH`) sigue existiendo y gana sobre todo: permite a los tests apuntar a un archivo temporal aislado sin montar contenedor — el mismo idioma que `MILPA_DESIGN_PATH` ya usa (ver `AdminPage` / `MilpaAdminShellTest`).

public static function bindStorageRoot(?Milpa\Admin\Contracts\StorageRootSource $source): void

El host declara su raíz de almacenamiento. `null` la desata — los tests que la aten deben soltarla en su `tearDown`, o se la heredan al siguiente. {@see \Milpa\Admin\AdminPlugin::boot()} la ata sola si el host registró un {@see StorageRootSource} en el contenedor.

Parameters

public static function path(): string

La ruta real del archivo de settings: el override de entorno, o lo que el host declaró.

public static function repository(): Milpa\Admin\Settings\SettingsRepository

Un {@see SettingsRepository} apuntando a la ruta compartida de {@see self::path()}.

public static function provider(): Milpa\Admin\Settings\SettingsStateProvider

El seam de lectura ({@see SettingsStateProvider}) sobre {@see self::repository()}.