feat: Add PublishedAt and URLField helper utilities

[ainsleyclark]

Summary

This PR adds two new reusable field helper utilities to the payload-helper package: PublishedAt and URLField. These helpers provide pre-configured Payload CMS fields with sensible defaults and common functionality.

Key Changes

• PublishedAt: A new date field helper that automatically:

  • Sets the current date as the default value
  • Populates the field when a document is first published
  • Configures the field with sidebar positioning and day-only date picker
  • Supports field overrides for customization

• URLField: A new virtual text field helper that:

  • Generates URLs dynamically via a custom generation function
  • Automatically appends ?draft=true query parameter when in draft mode
  • Displays as read-only in the admin interface
  • Supports async generation functions and field overrides

• Exports: Updated common/index.ts and main index.ts to export both new utilities and their TypeScript types

Implementation Details

• Both utilities follow the existing pattern of accepting optional overrides parameter for field customization
• PublishedAt uses a beforeChange hook to set the date when status changes to published
• URLField uses an afterRead hook to dynamically generate the URL based on document data
• Comprehensive test coverage included for both utilities (127 and 81 test cases respectively)
• Uses Payload's deepMerge utility for proper field override handling in URLField

https://claude.ai/code/session_01NwyDXYNHC8fkcbWpmRpBfg

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 69.94%. Comparing base (7f6b060) to head (6cb4dd9).
⚠️ Report is 502 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #415      +/-   ##
==========================================
+ Coverage   64.59%   69.94%   +5.35%     
==========================================
  Files         154      185      +31     
  Lines        6064     7394    +1330     
==========================================
+ Hits         3917     5172    +1255     
+ Misses       2064     2025      -39     
- Partials       83      197     +114     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.