WIP: fix polyfill declaration

Closes humbug#965.

.makefile/e2e.file

@@ -431,6 +431,24 @@ e2e_039: $(PHP_SCOPER_PHAR_BIN)
 		> build/set039/output || true
 	diff fixtures/set039-min-php-version/expected-output build/set039/output
 
+.PHONY: e2e_040
+e2e_040: # Runs end-to-end tests for the fixture set e2e_040 — Codebase using a polyfill
+e2e_040: $(PHP_SCOPER_PHAR_BIN)
+	rm -rf fixtures/set040-polyfills/vendor || true
+	composer --working-dir=fixtures/set040-polyfills dump-autoload
+
+	$(PHP_SCOPER_PHAR) add-prefix . \
+		--working-dir=fixtures/set040-polyfills \
+		--output-dir=../../build/set040 \
+		--force \
+		--no-interaction \
+		--stop-on-failure
+	composer --working-dir=build/set040 dump-autoload
+
+	php build/set040/index.php > build/set040/output || true
+
+	diff fixtures/set040-polyfills/expected-output build/set040/output
+
 
 #
 # Rules from files

fixtures/set040-polyfills/bootstrap.php

@@ -0,0 +1,15 @@
+<?php declare(strict_types=1);
+
+use Set040\Php20;
+
+if (PHP_VERSION_ID >= 200_000) {
+    return;
+}
+
+if (!defined('NEW_PHP20_CONSTANT')) {
+    define('NEW_PHP20_CONSTANT', 42);
+}
+
+if (!function_exists('new_php20_function')) {
+    function new_php20_function(bool $echo = false): void { Php20::new_php20_function($echo); }
+}

fixtures/set040-polyfills/composer.json

@@ -0,0 +1,11 @@
+{
+    "bin": "index.php",
+    "autoload": {
+        "files": ["bootstrap.php"],
+        "classmap": ["stubs"],
+        "psr-4": {
+            "Set040\\Polyfill\\": "src/",
+            "Set040\\": "src/"
+        }
+    }
+}

fixtures/set040-polyfills/expected-output

@@ -0,0 +1 @@
+OK.

fixtures/set040-polyfills/index.php

@@ -0,0 +1,27 @@
+<?php declare(strict_types=1);
+
+namespace App;
+
+use NewPhp20Interface;
+use NewPhp20Class;
+use function new_php20_function;
+use const NEW_PHP20_CONSTANT;
+use const PHP_EOL;
+
+require file_exists(__DIR__.'/vendor/scoper-autoload.php')
+    ? __DIR__.'/vendor/scoper-autoload.php'
+    : __DIR__.'/vendor/autoload.php';
+
+// This file mimics the execution of an app relying on a polyfill.
+//
+// From PHP-Scoper point of view, marking a symbol as excluded is
+// akin to say this is a PHP native symbol.
+
+// Consume the polyfilled code.
+
+class NewPhp20Child implements NewPhp20Interface {}
+new NewPhp20Class();
+new_php20_function();
+$x = NEW_PHP20_CONSTANT;
+
+echo "OK.".PHP_EOL;

fixtures/set040-polyfills/scoper.inc.php

@@ -0,0 +1,14 @@
+<?php declare(strict_types=1);
+
+return [
+    'exclude-classes' => [
+        'NewPhp20Interface',
+        'NewPhp20Class',
+    ],
+    'exclude-functions' => [
+        'new_php20_function',
+    ],
+    'exclude-constants' => [
+        'NEW_PHP20_CONSTANT',
+    ],
+];

fixtures/set040-polyfills/src/Php20.php

@@ -0,0 +1,17 @@
+<?php declare(strict_types=1);
+
+namespace Set040;
+
+final class Php20
+{
+    public static function new_php20_function(bool $echo = false): void
+    {
+        if ($echo) {
+            echo "Called `new_php20_function()`.";
+        }
+    }
+
+    private function __construct()
+    {
+    }
+}

fixtures/set040-polyfills/stubs/NewPhp20Class.php

@@ -0,0 +1,7 @@
+<?php declare(strict_types=1);
+
+if (PHP_VERSION_ID < 200_000) {
+    final class NewPhp20Class
+    {
+    }
+}

fixtures/set040-polyfills/stubs/NewPhp20Interface.php

@@ -0,0 +1,7 @@
+<?php declare(strict_types=1);
+
+if (PHP_VERSION_ID < 200_000) {
+    interface NewPhp20Interface
+    {
+    }
+}