Adopt reusable CI standard + PHPUnit suite (#8)

* feat(ci): adopt estate CI + add PHPUnit suite from scratch (v1.2.0)

- Add PHPUnit 9.6 test suite (WP stubs, tests: stubs) — 40 tests across 4 files:
  MathTest: 25 tests covering all PRC_Math public methods and calculate()
  orchestrator with real peptide scenarios (BPC-157/TB-500/Semaglutide/MK-677/
  Ipamorelin) plus edge cases (zero water, negative inputs, floor rounding,
  rounding precision, mcg↔mg conversion).
  DefaultPresetsTest: 11 tests — all 8 expected slugs, required keys per preset
  (dataProvider), dose_unit validity, min<max range, source field, spot-checks.
  RestControllerTest: 7 tests — calculate() 200 + correct values (mcg+mg),
  get_presets() 200, get_preset() 200 for known slug / WP_Error for unknown.
  PresetProviderTest: 4 tests — fallback to defaults sans PR Core, slug key
  present, cache invalidation, idempotent invalidation.
- Add phpunit.xml.dist + tests/bootstrap.php (WP function/class stubs).
- Add composer test script: vendor/bin/phpunit --configuration phpunit.xml.dist.
- Add phpunit/phpunit ^9.6 + yoast/phpunit-polyfills ^2.0 to require-dev.
- Replace standalone ci.yml with thin caller to estate reusable workflow:
  uses: peptiderepo/peptide-e2e/.github/workflows/ci.yml@main
  with: tests: stubs, has_js: true
  permissions: contents: write (required for phpcbf commit-back)
  workflow_call (required for deploy.yml gate).
- deploy.yml unchanged — already gates on ./ci.yml + uses shared deploy-app.yml.
- Version bump 1.1.0 → 1.2.0.

Agent-Session: claude/adopt-ci-20260616

* style: auto-fix PHPCS violations via phpcbf

* fix(ci): resolve latent PHPCS + JS lint failures

Latent debt surfaced by the reusable PHPCS job (previously continue-on-error).

PHPCS fixes (all pre-existing, not introduced by this PR):
- Add @package PeptideReconstitutionCalculator to file docblocks in all 12 PHP
  files (previously missing; phpcbf cannot insert missing docblock tags).
- Replace two short-ternary ?: operators in class-prc-preset-provider.php with
  full ternary (Universal.Operators.DisallowShortTernary.Found; lines 136+152).

JS lint fix:
- Add package.json + package-lock.json (no deps; lint script = node --check)
  so the reusable lint-js job's npm ci / cache: npm steps succeed. The
  calculator ships vanilla JS with no build toolchain — package.json is the
  minimal stub the reusable workflow requires for has_js: true.

Agent-Session: claude/adopt-ci-20260616

* style: auto-fix PHPCS violations via phpcbf

* fix(phpcs): suppress intentional warnings with phpcs:ignore annotations

uninstall.php: direct wpdb->query() intentional in uninstall (no caching
available); add phpcs:ignore DirectDatabaseQuery.DirectQuery and NoCaching.
class-prc-rest-controller.php get_presets(): request param required by
WP REST API callback contract; add phpcs:ignore UnusedFunctionParameter.

Agent-Session: claude/adopt-ci-20260616

---------

Co-authored-by: peptiderepo <bot@peptiderepo.com>
Co-authored-by: peptiderepo <peptiderepo@users.noreply.github.com>
This commit is contained in:
peptiderepo
2026-06-17 01:25:11 +07:00
committed by GitHub
parent 99b66c6370
commit 31ad0463f7
23 changed files with 1517 additions and 186 deletions

View File

@@ -10,6 +10,7 @@
* @see assets/js/calculator.js — Client-side calculator logic.
* @see assets/css/calculator.css — Calculator styles.
* @see class-prc-calculator.php — Boot orchestrator.
* @package PeptideReconstitutionCalculator
*/
declare(strict_types=1);
@@ -34,7 +35,7 @@ class PRC_Shortcode {
* @return void Side effect: registers shortcode.
*/
public function register(): void {
add_shortcode( 'prc_calculator', [ $this, 'render' ] );
add_shortcode( 'prc_calculator', array( $this, 'render' ) );
}
/**
@@ -47,11 +48,11 @@ class PRC_Shortcode {
* @param array<string, string>|string $atts Shortcode attributes.
* @return string HTML output.
*/
public function render( $atts = [] ): string {
public function render( $atts = array() ): string {
$atts = shortcode_atts(
[
array(
'peptide' => '', // Pre-select a peptide by slug.
],
),
$atts,
'prc_calculator'
);
@@ -81,14 +82,14 @@ class PRC_Shortcode {
wp_enqueue_style(
'prc-calculator',
PRC_PLUGIN_URL . 'assets/css/calculator.css',
[],
array(),
PRC_VERSION
);
wp_enqueue_script(
'prc-calculator',
PRC_PLUGIN_URL . 'assets/js/calculator.js',
[],
array(),
PRC_VERSION,
true
);
@@ -96,23 +97,27 @@ class PRC_Shortcode {
// Pass presets and config to JS — all REST endpoints are public-read,
// so no nonce is needed. The restUrl is provided for future use.
$provider = new PRC_Preset_Provider();
wp_localize_script( 'prc-calculator', 'prcConfig', [
'presets' => $provider->get_all_presets(),
'restUrl' => esc_url_raw( rest_url( 'prc/v1' ) ),
'syringeUnits' => 100, // Must match PRC_Math::SYRINGE_UNITS_PER_ML and calculator.js SYRINGE_UNITS_PER_ML.
'i18n' => [
'selectPeptide' => __( 'Select a peptide…', 'peptide-reconstitution-calculator' ),
'customEntry' => __( 'Custom / Manual Entry', 'peptide-reconstitution-calculator' ),
'calculate' => __( 'Calculate', 'peptide-reconstitution-calculator' ),
'reset' => __( 'Reset', 'peptide-reconstitution-calculator' ),
'concentration' => __( 'Concentration', 'peptide-reconstitution-calculator' ),
'injectionVol' => __( 'Injection Volume', 'peptide-reconstitution-calculator' ),
'syringeUnits' => __( 'Syringe Units', 'peptide-reconstitution-calculator' ),
'dosesPerVial' => __( 'Doses Per Vial', 'peptide-reconstitution-calculator' ),
'perUnit' => __( 'per unit', 'peptide-reconstitution-calculator' ),
'disclaimer' => __( 'For informational purposes only. Not medical advice. Always consult a qualified healthcare professional.', 'peptide-reconstitution-calculator' ),
],
] );
wp_localize_script(
'prc-calculator',
'prcConfig',
array(
'presets' => $provider->get_all_presets(),
'restUrl' => esc_url_raw( rest_url( 'prc/v1' ) ),
'syringeUnits' => 100, // Must match PRC_Math::SYRINGE_UNITS_PER_ML and calculator.js SYRINGE_UNITS_PER_ML.
'i18n' => array(
'selectPeptide' => __( 'Select a peptide…', 'peptide-reconstitution-calculator' ),
'customEntry' => __( 'Custom / Manual Entry', 'peptide-reconstitution-calculator' ),
'calculate' => __( 'Calculate', 'peptide-reconstitution-calculator' ),
'reset' => __( 'Reset', 'peptide-reconstitution-calculator' ),
'concentration' => __( 'Concentration', 'peptide-reconstitution-calculator' ),
'injectionVol' => __( 'Injection Volume', 'peptide-reconstitution-calculator' ),
'syringeUnits' => __( 'Syringe Units', 'peptide-reconstitution-calculator' ),
'dosesPerVial' => __( 'Doses Per Vial', 'peptide-reconstitution-calculator' ),
'perUnit' => __( 'per unit', 'peptide-reconstitution-calculator' ),
'disclaimer' => __( 'For informational purposes only. Not medical advice. Always consult a qualified healthcare professional.', 'peptide-reconstitution-calculator' ),
),
)
);
$this->assets_enqueued = true;
}
@@ -155,7 +160,7 @@ class PRC_Shortcode {
<select id="prc-vial-select" class="prc-field__input prc-field__input--half"></select>
<div class="prc-field__custom-wrap">
<input type="number" id="prc-vial-mg" class="prc-field__input prc-field__input--half"
step="0.1" min="0.1" placeholder="5" />
step="0.1" min="0.1" placeholder="5" />
<span class="prc-field__unit"><?php esc_html_e( 'mg', 'peptide-reconstitution-calculator' ); ?></span>
</div>
</div>
@@ -168,7 +173,7 @@ class PRC_Shortcode {
</label>
<div class="prc-field__row">
<input type="number" id="prc-water-ml" class="prc-field__input"
step="0.1" min="0.1" placeholder="2.0" />
step="0.1" min="0.1" placeholder="2.0" />
<span class="prc-field__unit"><?php esc_html_e( 'mL', 'peptide-reconstitution-calculator' ); ?></span>
</div>
</div>
@@ -180,7 +185,7 @@ class PRC_Shortcode {
</label>
<div class="prc-field__row">
<input type="number" id="prc-desired-dose" class="prc-field__input"
step="any" min="0" placeholder="250" />
step="any" min="0" placeholder="250" />
<select id="prc-dose-unit" class="prc-field__input prc-field__input--unit">
<option value="mcg">mcg</option>
<option value="mg">mg</option>