Merge branch 'main' into zhiwei/collections-length-func

Author: ChihweiLHBird

.changes/1.15.1.md

@@ -0,0 +1,6 @@
+## 1.15.1 (July 31, 2025)
+
+BUG FIXES:
+
+* all: Fixed bug with `UseStateForUnknown` where known null state values were not preserved during update plans. ([#1117](https://github.com/hashicorp/terraform-plugin-framework/issues/1117))
+

.changes/1.16.0-alpha.1.md

@@ -0,0 +1,11 @@
+## 1.16.0-alpha.1 (July 22, 2025)
+
+NOTES:
+
+* This alpha pre-release contains the initial implementation for list resource that returns a list of resource identities for a single managed resource type. ([#1157](https://github.com/hashicorp/terraform-plugin-framework/issues/1157))
+* The ListResource and ValidateListResourceConfig RPCs are considered experimental and may change up until general availability ([#1178](https://github.com/hashicorp/terraform-plugin-framework/issues/1178))
+
+BUG FIXES:
+
+* all: Fixed bug with `UseStateForUnknown` where known null state values were not preserved during update plans. ([#1117](https://github.com/hashicorp/terraform-plugin-framework/issues/1117))
+

.changes/1.16.0-beta.1.md

@@ -0,0 +1,18 @@
+## 1.16.0-beta.1 (July 31, 2025)
+
+FEATURES:
+
+* actions: Initial package implementation and new Actions RPC support ([#1181](https://github.com/hashicorp/terraform-plugin-framework/issues/1181))
+
+ENHANCEMENTS:
+
+* list: add `limit` field to `ListResult` ([#1182](https://github.com/hashicorp/terraform-plugin-framework/issues/1182))
+* list: add primitives, list and map types to schema ([#1177](https://github.com/hashicorp/terraform-plugin-framework/issues/1177))
+* actions: add schema interface and unlinked schema ([#1183](https://github.com/hashicorp/terraform-plugin-framework/issues/1183))
+* actions: add standard validation methods and interfaces for `ValidateActionConfig` RPCs ([#1188](https://github.com/hashicorp/terraform-plugin-framework/issues/1188))
+* actions: add attributes and nested blocks to schema package ([#1186](https://github.com/hashicorp/terraform-plugin-framework/issues/1186))
+
+BUG FIXES:
+
+* list: call `Configure` in `ListResource` RPC and remove the `ListResource` call in `ValidateListResourceConfig` ([#1192](https://github.com/hashicorp/terraform-plugin-framework/issues/1192))
+

.changes/unreleased/BUG FIXES-20250612-115411.yaml

@@ -1,3 +1,38 @@
+## 1.16.0-beta.1 (July 31, 2025)
+
+FEATURES:
+
+* actions: Initial package implementation and new Actions RPC support ([#1181](https://github.com/hashicorp/terraform-plugin-framework/issues/1181))
+
+ENHANCEMENTS:
+
+* list: add `limit` field to `ListResult` ([#1182](https://github.com/hashicorp/terraform-plugin-framework/issues/1182))
+* list: add primitives, list and map types to schema ([#1177](https://github.com/hashicorp/terraform-plugin-framework/issues/1177))
+* actions: add schema interface and unlinked schema ([#1183](https://github.com/hashicorp/terraform-plugin-framework/issues/1183))
+* actions: add standard validation methods and interfaces for `ValidateActionConfig` RPCs ([#1188](https://github.com/hashicorp/terraform-plugin-framework/issues/1188))
+* actions: add attributes and nested blocks to schema package ([#1186](https://github.com/hashicorp/terraform-plugin-framework/issues/1186))
+
+BUG FIXES:
+
+* list: call `Configure` in `ListResource` RPC and remove the `ListResource` call in `ValidateListResourceConfig` ([#1192](https://github.com/hashicorp/terraform-plugin-framework/issues/1192))
+
+## 1.16.0-alpha.1 (July 22, 2025)
+
+NOTES:
+
+* This alpha pre-release contains the initial implementation for list resource that returns a list of resource identities for a single managed resource type. ([#1157](https://github.com/hashicorp/terraform-plugin-framework/issues/1157))
+* The ListResource and ValidateListResourceConfig RPCs are considered experimental and may change up until general availability ([#1178](https://github.com/hashicorp/terraform-plugin-framework/issues/1178))
+
+BUG FIXES:
+
+* all: Fixed bug with `UseStateForUnknown` where known null state values were not preserved during update plans. ([#1117](https://github.com/hashicorp/terraform-plugin-framework/issues/1117))
+
+## 1.15.1 (July 31, 2025)
+
+BUG FIXES:
+
+* all: Fixed bug with `UseStateForUnknown` where known null state values were not preserved during update plans. ([#1117](https://github.com/hashicorp/terraform-plugin-framework/issues/1117))
+
 ## 1.15.0 (May 16, 2025)
 
 NOTES:

CHANGELOG.md

@@ -49,3 +49,33 @@ type ActionWithModifyPlan interface {
 	// diagnostics to practitioners, such as validation errors.
 	ModifyPlan(context.Context, ModifyPlanRequest, *ModifyPlanResponse)
 }
+
+// ActionWithConfigValidators is an interface type that extends Action to include declarative validations.
+//
+// Declaring validation using this methodology simplifies implementation of
+// reusable functionality. These also include descriptions, which can be used
+// for automating documentation.
+//
+// Validation will include ConfigValidators and ValidateConfig, if both are
+// implemented, in addition to any Attribute or Type validation.
+type ActionWithConfigValidators interface {
+	Action
+
+	// ConfigValidators returns a list of functions which will all be performed during validation.
+	ConfigValidators(context.Context) []ConfigValidator
+}
+
+// ActionWithValidateConfig is an interface type that extends Action to include imperative validation.
+//
+// Declaring validation using this methodology simplifies one-off
+// functionality that typically applies to a single action. Any documentation
+// of this functionality must be manually added into schema descriptions.
+//
+// Validation will include ConfigValidators and ValidateConfig, if both are
+// implemented, in addition to any Attribute or Type validation.
+type ActionWithValidateConfig interface {
+	Action
+
+	// ValidateConfig performs the validation.
+	ValidateConfig(context.Context, ValidateConfigRequest, *ValidateConfigResponse)
+}

action/action.go

@@ -0,0 +1,27 @@
+// Copyright (c) HashiCorp, Inc.
+// SPDX-License-Identifier: MPL-2.0
+
+package action
+
+import "context"
+
+// ConfigValidator describes reusable Action configuration validation functionality.
+type ConfigValidator interface {
+	// Description describes the validation in plain text formatting.
+	//
+	// This information may be automatically added to action plain text
+	// descriptions by external tooling.
+	Description(context.Context) string
+
+	// MarkdownDescription describes the validation in Markdown formatting.
+	//
+	// This information may be automatically added to action Markdown
+	// descriptions by external tooling.
+	MarkdownDescription(context.Context) string
+
+	// ValidateAction performs the validation.
+	//
+	// This method name is separate from ConfigValidators in resource and other packages in
+	// order to allow generic validators.
+	ValidateAction(context.Context, ValidateConfigRequest, *ValidateConfigResponse)
+}

action/config_validator.go

@@ -8,13 +8,16 @@ import (
 
 	"github.com/hashicorp/terraform-plugin-framework/attr"
 	"github.com/hashicorp/terraform-plugin-framework/internal/fwschema"
+	"github.com/hashicorp/terraform-plugin-framework/internal/fwschema/fwxschema"
+	"github.com/hashicorp/terraform-plugin-framework/schema/validator"
 	"github.com/hashicorp/terraform-plugin-framework/types"
 	"github.com/hashicorp/terraform-plugin-framework/types/basetypes"
 )
 
 // Ensure the implementation satisfies the desired interfaces.
 var (
-	_ Attribute = BoolAttribute{}
+	_ Attribute                             = BoolAttribute{}
+	_ fwxschema.AttributeWithBoolValidators = BoolAttribute{}
 )
 
 // BoolAttribute represents a schema attribute that is a boolean. When
@@ -89,6 +92,18 @@ type BoolAttribute struct {
 	//  - https://github.com/hashicorp/terraform/issues/7569
 	//
 	DeprecationMessage string
+
+	// Validators define value validation functionality for the attribute. All
+	// elements of the slice of AttributeValidator are run, regardless of any
+	// previous error diagnostics.
+	//
+	// Many common use case validators can be found in the
+	// github.com/hashicorp/terraform-plugin-framework-validators Go module.
+	//
+	// If the Type field points to a custom type that implements the
+	// xattr.TypeWithValidate interface, the validators defined in this field
+	// are run in addition to the validation defined by the type.
+	Validators []validator.Bool
 }
 
 // ApplyTerraform5AttributePathStep always returns an error as it is not
@@ -167,3 +182,8 @@ func (a BoolAttribute) IsRequiredForImport() bool {
 func (a BoolAttribute) IsOptionalForImport() bool {
 	return false
 }
+
+// BoolValidators returns the Validators field value.
+func (a BoolAttribute) BoolValidators() []validator.Bool {
+	return a.Validators
+}

action/schema/bool_attribute.go

@@ -16,6 +16,7 @@ import (
 	"github.com/hashicorp/terraform-plugin-framework/internal/fwschema"
 	"github.com/hashicorp/terraform-plugin-framework/internal/testing/testschema"
 	"github.com/hashicorp/terraform-plugin-framework/internal/testing/testtypes"
+	"github.com/hashicorp/terraform-plugin-framework/schema/validator"
 	"github.com/hashicorp/terraform-plugin-framework/types"
 )
 
@@ -435,3 +436,35 @@ func TestBoolAttributeIsOptionalForImport(t *testing.T) {
 		})
 	}
 }
+
+func TestBoolAttributeBoolValidators(t *testing.T) {
+	t.Parallel()
+
+	testCases := map[string]struct {
+		attribute schema.BoolAttribute
+		expected  []validator.Bool
+	}{
+		"no-validators": {
+			attribute: schema.BoolAttribute{},
+			expected:  nil,
+		},
+		"validators": {
+			attribute: schema.BoolAttribute{
+				Validators: []validator.Bool{},
+			},
+			expected: []validator.Bool{},
+		},
+	}
+
+	for name, testCase := range testCases {
+		t.Run(name, func(t *testing.T) {
+			t.Parallel()
+
+			got := testCase.attribute.BoolValidators()
+
+			if diff := cmp.Diff(got, testCase.expected); diff != "" {
+				t.Errorf("unexpected difference: %s", diff)
+			}
+		})
+	}
+}

action/schema/bool_attribute_test.go

@@ -8,13 +8,16 @@ import (
 
 	"github.com/hashicorp/terraform-plugin-framework/attr"
 	"github.com/hashicorp/terraform-plugin-framework/internal/fwschema"
+	"github.com/hashicorp/terraform-plugin-framework/internal/fwschema/fwxschema"
+	"github.com/hashicorp/terraform-plugin-framework/schema/validator"
 	"github.com/hashicorp/terraform-plugin-framework/types"
 	"github.com/hashicorp/terraform-plugin-framework/types/basetypes"
 )
 
 // Ensure the implementation satisifies the desired interfaces.
 var (
-	_ Attribute = DynamicAttribute{}
+	_ Attribute                                = DynamicAttribute{}
+	_ fwxschema.AttributeWithDynamicValidators = DynamicAttribute{}
 )
 
 // DynamicAttribute represents a schema attribute that is a dynamic, rather
@@ -90,6 +93,18 @@ type DynamicAttribute struct {
 	//  - https://github.com/hashicorp/terraform/issues/7569
 	//
 	DeprecationMessage string
+
+	// Validators define value validation functionality for the attribute. All
+	// elements of the slice of AttributeValidator are run, regardless of any
+	// previous error diagnostics.
+	//
+	// Many common use case validators can be found in the
+	// github.com/hashicorp/terraform-plugin-framework-validators Go module.
+	//
+	// If the Type field points to a custom type that implements the
+	// xattr.TypeWithValidate interface, the validators defined in this field
+	// are run in addition to the validation defined by the type.
+	Validators []validator.Dynamic
 }
 
 // ApplyTerraform5AttributePathStep always returns an error as it is not
@@ -168,3 +183,8 @@ func (a DynamicAttribute) IsRequiredForImport() bool {
 func (a DynamicAttribute) IsOptionalForImport() bool {
 	return false
 }
+
+// DynamicValidators returns the Validators field value.
+func (a DynamicAttribute) DynamicValidators() []validator.Dynamic {
+	return a.Validators
+}