bear/app-meta

Added

• $buildDir on AbstractAppMeta: {appDir}/var/build/{context}, fixed to appDir regardless of $writeDir and not created
• AbstractAppMeta::__wakeup() re-points paths under appDir when the application has moved since serialization
• Meta refuses a relative $appDir, $tmpDir or $logDir with WriteDirNotAbsoluteException

Changed

• Meta::appDir($name) moved to AbstractAppMeta and returns the canonical spelling, as do $appDir, $tmpDir and $logDir
• Canonical spellings make existing compile markers mismatch once: recompile when deploying this release (a writable tree recompiles on first boot; a read-only tree must be rebuilt)

Deprecated

• $writeDir on AbstractAppMeta: still filled for released bear/package versions that read it; removal is a BC break and waits for the next major

Added

• $buildDir on AbstractAppMeta: {appDir}/var/build/{context}, fixed to appDir regardless of $writeDir and not created
• AbstractAppMeta::__wakeup() re-points paths under appDir when the application has moved since serialization
• Meta refuses a relative $appDir, $tmpDir or $logDir with WriteDirNotAbsoluteException

Changed

• Meta::appDir($name) moved to AbstractAppMeta and returns the canonical spelling, as do $appDir, $tmpDir and $logDir
• Canonical spellings make existing compile markers mismatch once: recompile when deploying this release (a writable tree recompiles on first boot; a read-only tree must be rebuilt)

Deprecated

• $writeDir on AbstractAppMeta: still filled for released bear/package versions that read it; removal is a BC break and waits for the next major

Added

• Meta::create($name, $context, $appDir, $writeDir) places an application under {writeDir}/{Vendor}/{Project}/{context}, or its own var/ when null
• $writeDir on AbstractAppMeta: the base an application writes under, carried rather than derived
• Meta::appDir($name) resolves an application directory from its name
• Meta::create() refuses a write directory the current directory would resolve, with WriteDirNotAbsoluteException

Added

• Meta::create($name, $context, $appDir, $writeDir) places an application under {writeDir}/{Vendor}/{Project}/{context}, or its own var/ when null
• $writeDir on AbstractAppMeta: the base an application writes under, carried rather than derived
• Meta::appDir($name) resolves an application directory from its name
• Meta::create() refuses a write directory the current directory would resolve, with WriteDirNotAbsoluteException

Added

• Optional $tmpDir and $logDir constructor arguments on Meta (defaults unchanged: {appDir}/var/tmp/{context} and {appDir}/var/log/{context}) (#41)

Changed

• Centralize directory creation and writability checks in ensureDir()
• Default path segments use / (portable on Windows PHP)

Usage

// defaults
new Meta('MyVendor\\Project', 'prod-app', $appDir);

// overrides (resolved paths only; env is the app's job)
new Meta('MyVendor\\Project', 'prod-app', $appDir, '/var/tmp/my-app', '/var/log/my-app');

Full changelog

1.10.0...1.11.0

Added

• Optional $tmpDir and $logDir constructor arguments on Meta (defaults unchanged: {appDir}/var/tmp/{context} and {appDir}/var/log/{context}) (#41)

Changed

• Centralize directory creation and writability checks in ensureDir()
• Default path segments use / (portable on Windows PHP)

What's Changed

Added

• Domain type aliases following BEAR.Package conventions
• PHP 8.5 support in CI test matrix
• Readonly properties for ResMeta value object

Changed

• BREAKING: Minimum PHP version upgraded from 8.0 to 8.1
• Lowered dependency requirements for better compatibility (bear/resource ^1.0, koriym/psr4list ^1.0.2)
• Updated PHPUnit to ^9.6 for PHP 8.1 support
• Achieve 100% Psalm type inference

Removed

• Removed post-install/update-cmd scripts for CI compatibility
• Removed phpmetrics dependency

Fixed

• Windows path separator issues in tests

Full Changelog: 1.9.0...1.10.0

Added

• Domain type aliases following BEAR.Package conventions (Types.php)
• PHP 8.5 support in CI test matrix
• Readonly properties for ResMeta value object
• Private constructor to Types class to prevent instantiation
• Literal union type for Scheme ('app'|'page'|'*')

Changed

• BREAKING: Minimum PHP version upgraded from 8.0 to 8.1
• Lowered bear/resource requirement from ^1.26 to ^1.0 for better compatibility
• Lowered koriym/psr4list requirement from ^1.4 to ^1.0.2 for better compatibility
• Updated PHPUnit from ^9.5.10 to ^9.6 for PHP 8.1 readonly support
• Updated coding standards dependencies (doctrine/coding-standard ^14.0, squizlabs/php_codesniffer ^4.0)
• Use @psalm-import-type pattern across all classes
• Remove duplicate @psalm-* annotations in favor of standard PHPDoc

Removed

• Removed post-install-cmd and post-update-cmd scripts for CI compatibility
• Removed phpmetrics dependency (incompatible with readonly keyword)

Fixed

• Windows path separator issues in tests
• Add descriptive assert messages for better debugging

Windows

• Enable Windows Compat

What's Changed

• Enable latest PHP compat by @koriym in #35
• Enable PHP8.4 and Windows compat: Normalize file path handling and refactor tests by @koriym in #36
• Update license copyright year(s) by @github-actions in #37

Full Changelog: 1.8.0...1.9.0

What's Changed

• Update license copyright year(s) by @github-actions in #33
• Drop PHP 7.3 and 7.4 and optimized for PHP 8 by @NaokiTsuchiya in #34

New Contributors

• @github-actions made their first contribution in #33
• @NaokiTsuchiya made their first contribution in #34

Full Changelog: 1.7.1...1.8.0

What's Changed

• PHP 8.1 support by @koriym in #30
• PHP 8.2 Support by @koriym in #31 Support by @koriym in #32

Full Changelog: 1.7.0...1.7.1

• Support PHP8 #29
• Update CI #28

1.6.1 seems to be cached incorrectly in Travis CI, so this release is a Refresh. 🤔

See https://travis-ci.org/github/bearsunday/BEAR.Package/jobs/701128249

• Refactor with psalm level max
• Generics notation in phpdoc