sympress / maker-bundle

v1.0.2 2026-10-02 11:14 UTC

Requires

• php: ^8.5
• composer-runtime-api: ^2.1
• symfony/maker-bundle: ^1.68
• symfony/process: ^8.1
• sympress/kernel: ^1.1.1

Requires (Dev)

• symfony/security-core: ^8.1
• symfony/validator: ^8.1
• sympress/qa: ^0.1.2

GPL-2.0-or-later

• Brian Schaffner

Published on Packagist.org on 2026-10-02 11:14 UTC

README

Package-aware integration for symfony/maker-bundle in SymPress website workspaces.

Installation

composer require --dev sympress/maker-bundle

The bundle imports Symfony MakerBundle's own services and maker registrations, then replaces the MakerBundle autoload resolver with a resolver that understands the local packages/* workspace and Composer-installed packages.

That keeps the MakerBundle command surface intact while letting generated PHP classes land in the package that owns their namespace:

./bin/console make:command 'Brianvarskonst\Theme\Command\RebuildEditorialIndexCommand'
./bin/console make:validator 'Brianvarskonst\Booking\Validator\BookingSlot'

If a command receives a fully-qualified class name, the resolver maps the longest matching PSR-4 namespace prefix to its package path. MakerBundle code paths that use Symfony's newer ClassData API, such as controllers and validators, are normalized to the same package-aware namespace rules.

Project-specific makers:

./bin/console make:sympress-package sympress/example
./bin/console make:sympress-package sympress/framework-addon --type=library
./bin/console make:sympress-package sympress/contracts --type=package
./bin/console make:sympress-package sympress/bootstrap --type=wordpress-mu-plugin
./bin/console make:sympress-package brianvarskonst/site-theme --type=wordpress-theme
./bin/console make:hook 'Brianvarskonst\Theme\Hook\ExampleHook' --hook init
./bin/console make:block 'Brianvarskonst\Booking\Block\ExampleBlock'
./bin/console make:config-loader brianvarskonst/booking
./bin/console make:asset-entry brianvarskonst/booking frontend --location=frontend
./bin/console make:data-provider 'Brianvarskonst\Theme\DataProvider\Templating\ExampleDataProvider'

make:sympress-package mirrors the package types already used in this workspace: library creates a kernel bundle library with a package-name entry, package creates a plain contracts/utility package without kernel metadata, wordpress-plugin and wordpress-muplugin create WordPress entry files, and wordpress-theme creates a theme bundle with functions.php and style.css. The human-friendly wordpress-mu-plugin alias is normalized to Composer's wordpress-muplugin type.

Optional configuration:

sympress_maker:
    root_namespace: 'Brianvarskonst\Theme'
    entity_namespace: 'Brianvarskonst\Theme\Entity'
    generate_final_classes: true
    generate_final_entities: false

Without explicit configuration, the bundle prefers the first WordPress theme namespace as the MakerBundle root namespace and falls back to the first discovered production PSR-4 namespace.

Development

composer install
composer tests
composer cs

The package repository ships its own QA workflow. Organization-wide issue templates and community defaults are provided by the SymPress .github repository.

License

This package is licensed under GPL-2.0-or-later.

Generated literals, output paths, and Process

PHP skeleton values use exported literals; JavaScript/TSX values use JSON-based quoting with escaped HTML delimiters and Unicode separators. Identifiers are validated separately, and generated frontend code compares data-block attribute values without interpolating user text into a CSS selector. Root project packages and nested packages both generate relative output paths. MakePackage --path must be relative and remain inside the canonical project, including nonexistent children of symlinks; traversal and absolute paths are rejected and checked again before writing. Project/cache parents must remain trusted while generation runs.

This bundle declares the real symfony/process ^8.1 dependency and integrates with symfony/maker-bundle ^1.68. It no longer provides a fictitious Symfony Process version through wp-cli/process. Generated PHP, webpack JavaScript and TSX/TS must be syntax checked alongside existing fixture contracts before release.