feat: add native search results vertical slice

.gitignore

@@ -3,10 +3,14 @@
 .env.*
 .idea/
 .vscode/
+.reference/
 node_modules/
 vendor/
 build/
 dist/
 coverage/
+modules-json/
+scripts/bundle.js
+styles/vb-bundle.css
 *.log
 *.zip

.npmrc

@@ -0,0 +1,2 @@
+engine-strict=true
+legacy-peer-deps=true

CHANGELOG.md

@@ -4,6 +4,61 @@
 
 ### Added
 
-- Open-source repository bootstrap.
-- Native Divi 5 parent/child module contract.
-- Shared renderer and optional-shortcode architecture.
+- Native Divi 5 `codecorn/search-results` parent module metadata and server registration.
+- Native `codecorn/search-result-type` child-rule metadata and server registration.
+- Current-query and isolated-query resolver without global query mutation.
+- Shared accessible renderer for result cards, summary, search form, pagination and empty state.
+- Optional `[cc_divi5_search_results]` adapter backed by the shared resolver and renderer.
+- Visual Builder TypeScript source, webpack build and responsive frontend styles.
+- README documentation contract requiring code and documentation to remain synchronized in every PR.
+- Explicit TypeScript validation through `npm run check:types` and aggregate validation through `npm run check`.
+- Repository `.npmrc` with strict engine enforcement and deterministic handling of incompatible Divi peer ranges.
+- Lockfile-safe `npm run reset-install` for rebuilding `node_modules` through `npm ci`.
+- Git exclusion for local proprietary references under `.reference/`.
+- Runtime-only package generation with build manifest and SHA-256 checksum.
+- VM deployment workflow supporting host and Docker WordPress installations.
+- Timestamped remote backups, retention pruning and automatic rollback on failed remote validation or activation.
+- Composer commands `package`, `deploy:check` and `deploy`.
+- Barbagia-specific Composer commands `deploy:barbagia:check` and `deploy:barbagia`.
+- Dedicated Barbagia wrapper pinned to `/home/fgirolami/docker/barbagiamusei/compose.yaml` and the `wp_cron` Compose service.
+- Dynamic resolution and validation of the real `wp_cron` container before remote deployment.
+- Barbagia deployment preflight requiring SSH public-key authentication and direct remote Docker API access.
+- Dynamic Visual Builder post-type selector populated from public WordPress post types, with labels and slugs.
+- `cc_d5sr_builder_post_type_options` filter for adjusting the post types exposed by the builder selector.
+- Three frontend output presets: editorial grid, compact vertical list and classic image card.
+- Independent desktop, tablet and phone column controls for grid-based presets.
+- Optional progressive AJAX pagination with loading state, browser history, focus restoration and classic navigation fallback.
+- Frontend JavaScript syntax validation through `npm run check:frontend`.
+- Custom CSS selector targets for summary, search form, results, cards, images, titles and pagination.
+- A second frontend theme layer with polished panel, form, card, list and pagination presentation.
+- `cc_d5sr_current_query_args` filter for the private query derived from the current search request.
+
+### Changed
+
+- Plugin bootstrap now supports Composer autoloading and a source-checkout fallback autoloader.
+- TypeScript compiler settings now emit the Divi Visual Builder bundle and follow the compatibility settings used by the official Divi 5 example modules.
+- Visual Builder attribute interfaces now use native Divi element types instead of generic unknown records.
+- Visual Builder edit and style renderers now guard optional props exposed by the published Divi types.
+- Development dependencies now include the transitive declarations required by the Divi 5.9.0 type packages.
+- Development documentation now requires committed npm and Composer lockfiles to remain synchronized with their manifests.
+- Release documentation now distinguishes ignored source-build outputs from files required in a distributable plugin archive.
+- Deployment documentation now defines reproducible packaging, dry-run behavior, remote requirements, backup location and rollback guarantees.
+- Generic Docker deployment documentation now distinguishes Docker container names or IDs from Compose service names.
+- Barbagia deployment no longer depends on the current SSH directory or a hardcoded container name.
+- Barbagia deployment now refuses password fallback and reports the remote Docker socket user, groups and permissions before any package upload.
+- Documentation now records that runtime packaging passed a disposable mock-repository test while the first real VM deployment remains an integration gate.
+- Visual Builder display names are now `CC Search Results` and `CC Result Type` while the saved technical module slugs remain unchanged.
+- The result-type post-type control is now a select instead of a free-text slug field.
+- The complete search form can be shown or hidden above the result output.
+- Default frontend copy is now Italian: `Cerca`, result counts, empty state, pagination labels and `Vedi risultato`.
+- Existing child modules that still contain the old exact default CTA `View result` are rendered as `Vedi risultato`; custom CTA labels are left untouched.
+- Frontend presentation now styles the search form, cards, metadata, pagination, loading state, focus states and reduced-motion behavior.
+- Parent and child module metadata now use the native Divi 5 `adminLabel` and `htmlAttributes` schema.
+- `source=current` now derives a private query from the current WordPress search context so module post types, page size and pagination are honored without mutating `$wp_query`.
+- Frontend CSS, JavaScript and Visual Builder bundles now use version-plus-filemtime cache keys during iterative deployments.
+
+### Fixed
+
+- The **Results per page** control is no longer ignored on real WordPress search pages or AJAX pagination requests.
+- Empty or invalid page-size values now fall back to 10 instead of collapsing to one result.
+- Grid column counts and result page sizes now operate independently, so a five-column layout can render the configured number of posts per page.