v1.1.0

Author: lucianofedericopereira

.gitattributes

@@ -0,0 +1,22 @@
+# Keep the Packagist dist tarball lean: development-only paths are not shipped
+# to consumers of `composer require phpcpd-next/phpcpd`.
+#
+# NOTE: integration/ is intentionally NOT export-ignored — it is mapped in the
+# production autoloader (the PHPUnit integration), so consumers need it.
+
+/tests              export-ignore
+/bench              export-ignore
+/paper              export-ignore
+/build              export-ignore
+/.github            export-ignore
+
+/.editorconfig          export-ignore
+/.gitattributes         export-ignore
+/.gitignore             export-ignore
+/.php-cs-fixer.dist.php  export-ignore
+/phpstan.neon           export-ignore
+/phpstan-stubs.php       export-ignore
+/phpunit.xml            export-ignore
+/rector.php             export-ignore
+
+*.php text eol=lf diff=php

.php-cs-fixer.dist.php

@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+/*
+ * This file is part of PhpcpdNext.
+ *
+ * (c) 2026 Luciano Federico Pereira
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+$finder = (new PhpCsFixer\Finder())
+    ->in([
+        __DIR__ . '/src',
+        __DIR__ . '/tests',
+        __DIR__ . '/integration',
+    ])
+    // Fixtures are hand-crafted inputs for the clone detector: reformatting them
+    // would shift the line/token counts the tests assert on. Never touch them.
+    ->exclude('fixtures')
+    ->append([__FILE__]);
+
+// This config codifies the style the codebase already follows (notably the
+// function → const → class import grouping), so a fresh `composer lint` run is
+// green. Add rules deliberately, verifying with `--dry-run` that they don't
+// trigger an unrelated mass reformat.
+return (new PhpCsFixer\Config())
+    ->setRiskyAllowed(true)
+    ->setRules([
+        'declare_strict_types'             => true,
+        'no_unused_imports'                => true,
+        'ordered_imports'                  => ['imports_order' => ['function', 'const', 'class'], 'sort_algorithm' => 'none'],
+        'blank_line_between_import_groups' => true,
+        'single_quote'                     => true,
+        'array_syntax'                     => ['syntax' => 'short'],
+        'no_trailing_whitespace'           => true,
+        'single_blank_line_at_eof'         => true,
+    ])
+    ->setFinder($finder);

CHANGELOG.md

@@ -10,6 +10,46 @@ Versioning: [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
 
 ---
 
+## [1.1.0] - 2026-06-28
+
+### Added — integrations
+
+- **Headless mode** (`LucianoPereira\PhpcpdNext\Phpcpd::detect()`): a one-call, in-process API that
+  finds files, runs the same engine the CLI uses, and returns the raw `CodeCloneMap` — no banner, no
+  argv parsing, no file I/O. The CLI and all embedders now share a single detection core (`Engine`),
+  so they can never disagree about what a clone is.
+- **Framework presets** (`--preset=<name>`, and `preset:` in the headless API): a named bundle of
+  paths, suffixes, and excludes — pure configuration, no runtime dependency. Ships with a **`laravel`**
+  preset (scans `app routes database config`; skips `vendor`, `storage`, `bootstrap/cache`, `public`,
+  Blade views, and migration boilerplate). Explicit flags seed-then-override the preset. New presets
+  are a single `Preset` entry in `src/Presets.php`.
+- **PHPUnit integration** (`integration/phpunit/`): an `AssertNoDuplication` trait and a
+  `DuplicationConstraint` that turn copy/paste detection into a regression test, with offending
+  locations (and `[inconsistent]` flags) printed on failure. Shipped in the **production**
+  autoloader under `LucianoPereira\PhpcpdNext\PHPUnit\`, so it works for any project that requires
+  phpcpd-next (even as `--dev`). phpcpd-next dogfoods it — `SelfDryTest` now keeps `src/` clean
+  through this exact trait.
+- **Laravel via Artisan**: documented (no extra package) by wiring the headless API into a command.
+
+### Packaging & distribution
+
+- **Published to Packagist** as `phpcpd-next/phpcpd`: `composer require --dev phpcpd-next/phpcpd`.
+- `composer.json`: added `type`, `keywords`, and a `suggest` for `phpunit/phpunit` (the optional
+  PHPUnit integration); moved the `PHPUnit\` namespace into the production autoloader.
+- Added `.gitattributes` with `export-ignore` rules so the dist tarball ships only runtime code
+  (`src/`, `integration/`, the binary), not tests, benchmarks, or tool configs.
+
+### Tooling
+
+- Committed a `.php-cs-fixer.dist.php` codifying the existing code style, so `composer lint` /
+  `composer check` run non-interactively.
+
+### Documentation
+
+- Reworked the README to document the **full** feature surface accurately: the real default
+  (Rabin-Karp + TokenBag) and `--rk`, all four output formats, the complete option reference split
+  into stable vs. advanced/research flags, presets, headless mode, and the PHPUnit integration.
+
 ## [1.0.0] - 2026-06-27
 
 ### Performance

CONTRIBUTING.md

@@ -60,6 +60,39 @@ proposed CLI/behaviour (for features). For detector-algorithm proposals, the
 research roadmap lives in [`ROADMAP.md`](ROADMAP.md) — check whether your idea is
 already a planned item (or explicitly out of scope) before opening.
 
+## Releasing & publishing to Packagist
+
+The package is published on Packagist as
+[`phpcpd-next/phpcpd`](https://packagist.org/packages/phpcpd-next/phpcpd).
+
+**One-time setup (maintainer):**
+
+1. Sign in to [packagist.org](https://packagist.org) → **Submit** → paste the
+   GitHub URL `https://github.com/phpcpd-next/phpcpd`.
+2. Enable auto-updates: install the **Packagist** GitHub app on the repo (or add
+   the Packagist webhook under *Settings → Webhooks*). New tags then publish
+   automatically.
+
+**Cutting a release:**
+
+```bash
+composer check                 # lint + analyse + test must all be green
+composer validate              # composer.json must be valid
+composer release 1.1.0         # bumps the VERSION constant (see bin/release.sh)
+```
+
+Then follow the steps the script prints: move the `[Unreleased]` CHANGELOG entries
+under the new version heading, commit, and push a **SemVer tag** (`git tag -s v1.1.0`).
+Packagist picks up the tag and publishes it. Verify with:
+
+```bash
+composer show phpcpd-next/phpcpd --all
+```
+
+The dist tarball is kept lean by `.gitattributes` (`export-ignore`): `tests/`,
+`bench/`, `paper/`, and tool configs are not shipped, but `src/`, `integration/`,
+and the `phpcpd` binary are.
+
 ## License
 
 By contributing, you agree that your contributions are licensed under the