(causeway) 03/03: docs(openspec): archive action button layout improvements

[da...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

danhaywood pushed a commit to branch htmx
in repository https://gitbox.apache.org/repos/asf/causeway.git

commit 320fed0244b7e73e9e34dc67e285d05bc3653ea4
Author: Dan Haywood <da...@haywood-associates.co.uk>
AuthorDate: Sun Aug 30 16:44:42 2026 +0200

    docs(openspec): archive action button layout improvements
---
 .../.openspec.yaml                                     |  0
 .../2026-08-30-improve-action-button-layout}/design.md |  0
 .../proposal.md                                        |  0
 .../specs/domain-web-components/spec.md                |  0
 .../specs/generic-htmx-web-component-viewer/spec.md    |  0
 .../2026-08-30-improve-action-button-layout}/tasks.md  |  0
 openspec/specs/domain-web-components/spec.md           | 17 +++++++++++++++++
 .../specs/generic-htmx-web-component-viewer/spec.md    | 18 ++++++++++++++++++
 8 files changed, 35 insertions(+)

diff --git a/openspec/changes/improve-action-button-layout/.openspec.yaml b/openspec/changes/archive/2026-08-30-improve-action-button-layout/.openspec.yaml
similarity index 100%
rename from openspec/changes/improve-action-button-layout/.openspec.yaml
rename to openspec/changes/archive/2026-08-30-improve-action-button-layout/.openspec.yaml
diff --git a/openspec/changes/improve-action-button-layout/design.md b/openspec/changes/archive/2026-08-30-improve-action-button-layout/design.md
similarity index 100%
rename from openspec/changes/improve-action-button-layout/design.md
rename to openspec/changes/archive/2026-08-30-improve-action-button-layout/design.md
diff --git a/openspec/changes/improve-action-button-layout/proposal.md b/openspec/changes/archive/2026-08-30-improve-action-button-layout/proposal.md
similarity index 100%
rename from openspec/changes/improve-action-button-layout/proposal.md
rename to openspec/changes/archive/2026-08-30-improve-action-button-layout/proposal.md
diff --git a/openspec/changes/improve-action-button-layout/specs/domain-web-components/spec.md b/openspec/changes/archive/2026-08-30-improve-action-button-layout/specs/domain-web-components/spec.md
similarity index 100%
rename from openspec/changes/improve-action-button-layout/specs/domain-web-components/spec.md
rename to openspec/changes/archive/2026-08-30-improve-action-button-layout/specs/domain-web-components/spec.md
diff --git a/openspec/changes/improve-action-button-layout/specs/generic-htmx-web-component-viewer/spec.md b/openspec/changes/archive/2026-08-30-improve-action-button-layout/specs/generic-htmx-web-component-viewer/spec.md
similarity index 100%
rename from openspec/changes/improve-action-button-layout/specs/generic-htmx-web-component-viewer/spec.md
rename to openspec/changes/archive/2026-08-30-improve-action-button-layout/specs/generic-htmx-web-component-viewer/spec.md
diff --git a/openspec/changes/improve-action-button-layout/tasks.md b/openspec/changes/archive/2026-08-30-improve-action-button-layout/tasks.md
similarity index 100%
rename from openspec/changes/improve-action-button-layout/tasks.md
rename to openspec/changes/archive/2026-08-30-improve-action-button-layout/tasks.md
diff --git a/openspec/specs/domain-web-components/spec.md b/openspec/specs/domain-web-components/spec.md
index 8d11956b29c..d21df7ce6e3 100644
--- a/openspec/specs/domain-web-components/spec.md
+++ b/openspec/specs/domain-web-components/spec.md
@@ -1898,3 +1898,20 @@ Icon metadata MUST be bounded and tokenized and MUST NOT inject markup or alter
 - **WHEN** action metadata has no accepted static Font Awesome classes or position
 - **THEN** no icon is rendered
 - **AND** the action name, usability, invocation, and focus behavior remain unchanged
+
+### Requirement: Field-aligned property-associated actions
+The component library SHALL place actions authored directly beneath a property in visual association with that property's field rather than its label while preserving semantic action behavior and light-DOM ownership.
+
+#### Scenario: Associated action renders at wide width
+- **WHEN** a property with a left-positioned label renders one or more associated actions at a wide layout width
+- **THEN** each associated action begins at the logical start of the property's field column
+- **AND** the label column remains free of action controls
+
+#### Scenario: Associated action renders at narrow width
+- **WHEN** responsive presentation stacks the property label and field
+- **THEN** associated actions begin at the same logical start as the stacked field
+- **AND** controls do not overlap, clip, or introduce horizontal page overflow
+
+#### Scenario: Associated action is activated
+- **WHEN** a user activates a field-aligned associated action
+- **THEN** the established semantic action request, toolkit selection, focus, disabled state, tooltip, and invocation behavior remain unchanged
diff --git a/openspec/specs/generic-htmx-web-component-viewer/spec.md b/openspec/specs/generic-htmx-web-component-viewer/spec.md
index fbb51358b9a..e07422f43c9 100644
--- a/openspec/specs/generic-htmx-web-component-viewer/spec.md
+++ b/openspec/specs/generic-htmx-web-component-viewer/spec.md
@@ -772,3 +772,21 @@ Petclinic HTML pages and domain actions SHALL demonstrate selected authored name
 - **WHEN** a Petclinic action has no new authored name, description, or icon metadata
 - **THEN** its established label, tooltip absence, and invocation behavior remain unchanged
 - **AND** no default icon is fabricated
+
+### Requirement: Application-owned Petclinic object heading actions
+The Petclinic owner custom page SHALL compose its object title and object-level actions in an application-owned responsive heading row without changing semantic object-header or action component contracts.
+
+#### Scenario: Owner page renders at wide width
+- **WHEN** a Petclinic owner route renders with sufficient inline space
+- **THEN** the remove-owner action appears immediately after the object title in the same heading row
+- **AND** the page does not place that object-level action in a separate toolbar row below the title
+
+#### Scenario: Owner heading has insufficient width
+- **WHEN** the title and object-level action cannot fit on one line
+- **THEN** the application heading row wraps in title-before-action document order
+- **AND** the title and action remain readable, operable, and free of overlap or horizontal page overflow
+
+#### Scenario: Application owns heading placement
+- **WHEN** the owner page composes the title and object-level action
+- **THEN** placement is defined by the Petclinic HTML resource and application stylesheet
+- **AND** `<cw-object-header>` and `<cw-action>` retain their established framework-neutral rendering and semantic behavior