mrpunyapal / nativephp-plugin-impressions

v0.1.1 2026-10-03 11:45 UTC

Requires

• php: ^8.2
• illuminate/contracts: ^12.0|^13.0
• illuminate/support: ^12.0|^13.0
• nativephp/mobile: ^4.5

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.24
• orchestra/testbench: ^10.0|^11.0
• pestphp/pest: ^4.0|^5.0
• pestphp/pest-plugin-laravel: ^4.0|^5.0
• phpstan/phpstan: ^2.1
• phpstan/phpstan-deprecation-rules: ^2.0
• rector/rector: ^2.1

MIT

• impressions
• nativephp
• nativephp-plugin
• nativephp-mobile
• nativephp-plugin-impressions

Published on Packagist.org on 2026-10-03 11:47 UTC

README

Visibility callbacks for NativePHP Mobile 4.5+ EDGE components on Android and iOS.

Wrap a post or another native element in <native:impression>. Fetching or composing an off-screen item does not count: the callback requires at least 50% of its visible target area for 500 milliseconds while the application is active. The target area is capped to the screen size so posts taller than the screen can still qualify.

Installation

For local development, check out this repository in the workspace's packages directory and add a Composer path repository (adjust the relative path for your application):

{
    "repositories": [
        {
            "type": "path",
            "url": "../../../packages/nativephp-plugin-impressions",
            "options": { "symlink": false, "reference": "none" }
        }
    ],
    "require": {
        "mrpunyapal/nativephp-plugin-impressions": "dev-main"
    }
}

Install with Composer and register MrPunyapal\Impressions\Providers\ImpressionsServiceProvider in the app's native plugin provider list. Validate from the application:

php artisan native:plugin:validate ../../../packages/nativephp-plugin-impressions

The custom renderers require a rebuilt application. Stock Jump does not include this plugin. A CI build using the path repository must provide the plugin at the relative path configured by the application; local-only plugin commits are not available to a GitHub runner.

Usage

<native:impression
    native:key="impression-{{ $post['id'] }}"
    identity="{{ $post['id'] }}"
    :enabled="true"
    :threshold="0.5"
    :dwell-ms="500"
    on-impression="recordPostView('{{ $post['id'] }}')"
    class="w-full"
>
    <native:text :text="$post['answer']" />
</native:impression>

The callback fires once per identity while that native element remains mounted. Re-entering the screen or remounting a virtualized row can fire it again. The application and server must deduplicate impressions using their own viewer identity and retention window. Send the API request asynchronously; do not count all prefetched posts or block scrolling while recording a view.

threshold is clamped to 0.01–1, and dwell-ms to 100–10000. Android requires API 26+, and iOS requires 18.2+. Visibility is geometric, not proof that the user read the content or that every possible overlay is absent.

Verification

composer validate --strict
composer test
composer analyse

PHP tests verify element serialization and manifest wiring. Native compilation and real-device scrolling/background testing remain necessary before release.