Filament Builder Title Laravel Package

Product Decisions This Supports

• Content authoring UX in Filament page builders. The package turns the read-only itemLabel on Builder blocks into an inline, editable title input in the block header — so editors can name a section ("Hero", "Testimonials", "Pricing") without expanding the block schema. This is a direct lever on "time to publish" and "clicks per edit" for any CMS/admin surface we ship on Filament.
• Repeater row labeling (new in v0.3.0). The Repeater::->title() macro extends the same inline-title pattern to repeater rows (FAQ entries, pricing tiers, nav links, feature lists). It replaces the static itemLabel when paired with Hidden::make($field), which means one consistent "name your row" interaction across both Builder and Repeater — a small but visible consistency win in admin UI.
• Build vs. buy / build vs. adopt. The scope is deliberately narrow: two form macros plus shared helpers, no migrations, no persistence layer, no data-model impact. Adopting this is materially cheaper than building and maintaining our own custom Filament header-input field, and it caps the "we own this forever" cost at near zero.
• Nested and preview layouts are first-class. v0.3.0 restores editable titles for ->preview() blocks (which Filament static-renders detached, so the wire path can't be resolved server-side) and resolves the path client-side from the builder item's DOM, which is correct for nested builders too. That matters for roadmap items involving multi-column/nested content layouts and preview-driven editing flows.
• Regression signal for upgrade decisions. The preview-block breakage was introduced in v0.2.0, not fixed until v0.3.0. Any team that adopted 0.2.x for page-builder work with ->preview() has been shipping a degraded editing experience; this release is the remediation, and the added detached-block regression guard is the kind of test coverage we want before leaning on the package in a customer-facing admin.

When to Consider This Package

Adopt when:

• We are on a supported Filament version and already use the Builder or Repeater form components in an admin/CMS surface.
• Editors genuinely need to rename blocks or rows inline — i.e., block identity is editorial (named sections, named repeatable items), not positional.
• We rely on ->preview() blocks and/or nested builders. This release explicitly targets both, and the client-side path resolution is the correct fix for detached rendering — do not stay on 0.2.x if this describes us.
• We want the Repeater behavior and accept the documented pairing with Hidden::make($field) for the underlying field.
• We can tolerate a pre-1.0, single-maintainer dependency with a small surface area (macros only) — pin the version and keep a render/smoke test on our side, mirroring their testbench coverage.

Look elsewhere when:

• We need a real page-builder (drag/drop across pages, revisioning, block library management). This package only addresses the title/label affordance, not builder architecture.
• We need title-field capabilities it does not advertise: per-title permissions/visibility gating, title localization/translation workflows, validation beyond firstError(), or title-driven search/indexing. Those would be custom work regardless.
• We cannot add a dependency maintained by a single author, or our Filament version is outside the supported range.
• Our block labels are purely positional/derived and never edited by humans — the inline input adds UI noise for no editorial benefit.

How to Pitch It (Stakeholders)

Executive summary. A small, single-purpose Filament add-on that makes section and row titles editable in place in our admin builder, instead of read-only labels. The practical effect is fewer clicks and less friction for content editors naming sections and repeatable items — a UX improvement in the authoring surface, not an architectural change. v0.3.0 fixes a real regression from v0.2.0 (preview blocks had lost their editable header) and extends the same behavior to repeater rows, so the package now covers both of our repeating-content patterns with one interaction model.

For engineering. Macros only: no migrations, no schema or data-model changes, no runtime services. v0.3.0 rebuilds the header input's wire path client-side from the builder item's DOM (x-sortable-item + x-on:builder-expand.window), which is the correct approach for detached ->preview() blocks and holds for nested builders; the release adds a render test asserting deep state-path binding plus a detached-block unit regression guard. New Repeater::->title() macro, intended to be paired with Hidden::make($field). Internal cleanup: shared titleInput()/firstError() helpers, and the macro closures' : static return type was dropped to clear a false intelephense(P1006).

Recommendation and caveats. Adopt (or upgrade to v0.3.0 immediately if already on 0.2.x with preview blocks). Pin the version — it is pre-1.0 and the 0.2.0 → 0.3.0 history shows the title-input path is the fragile part — and keep our own smoke test on preview and nested builders so a future upstream regression is caught in our suite rather than by editors.