[DRAFT] Transcribe proposed new state handling from Terraform Core

action/schema/unlinked_schema.go

@@ -6,11 +6,12 @@ package schema
 import (
 	"context"
 
+	"github.com/hashicorp/terraform-plugin-go/tftypes"
+
 	"github.com/hashicorp/terraform-plugin-framework/attr"
 	"github.com/hashicorp/terraform-plugin-framework/diag"
 	"github.com/hashicorp/terraform-plugin-framework/internal/fwschema"
 	"github.com/hashicorp/terraform-plugin-framework/path"
-	"github.com/hashicorp/terraform-plugin-go/tftypes"
 )
 
 var _ SchemaType = UnlinkedSchema{}
@@ -60,6 +61,10 @@ type UnlinkedSchema struct {
 
 func (s UnlinkedSchema) isActionSchemaType() {}
 
+func (s UnlinkedSchema) EmptyValue(ctx context.Context) tftypes.Value {
+	return fwschema.EmptySchemaValue(ctx, s)
+}
+
 // ApplyTerraform5AttributePathStep applies the given AttributePathStep to the
 // schema.
 func (s UnlinkedSchema) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (any, error) {

datasource/schema/schema.go

@@ -61,6 +61,10 @@ type Schema struct {
 	DeprecationMessage string
 }
 
+func (s Schema) EmptyValue(ctx context.Context) tftypes.Value {
+	return fwschema.EmptySchemaValue(ctx, s)
+}
+
 // ApplyTerraform5AttributePathStep applies the given AttributePathStep to the
 // schema.
 func (s Schema) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (any, error) {

ephemeral/schema/schema.go

@@ -61,6 +61,10 @@ type Schema struct {
 	DeprecationMessage string
 }
 
+func (s Schema) EmptyValue(ctx context.Context) tftypes.Value {
+	return fwschema.EmptySchemaValue(ctx, s)
+}
+
 // ApplyTerraform5AttributePathStep applies the given AttributePathStep to the
 // schema.
 func (s Schema) ApplyTerraform5AttributePathStep(step tftypes.AttributePathStep) (any, error) {

internal/fwschema/nested_block_object.go

@@ -6,10 +6,11 @@ package fwschema
 import (
 	"fmt"
 
+	"github.com/hashicorp/terraform-plugin-go/tftypes"
+
 	"github.com/hashicorp/terraform-plugin-framework/attr"
 	"github.com/hashicorp/terraform-plugin-framework/types"
 	"github.com/hashicorp/terraform-plugin-framework/types/basetypes"
-	"github.com/hashicorp/terraform-plugin-go/tftypes"
 )
 
 // NestedBlockObject represents the Object inside a Block.

internal/fwschema/schema.go

@@ -73,6 +73,9 @@ type Schema interface {
 	// AttributeTypeAtPath should return the framework type of the Attribute at
 	// the given Terraform path or return an error.
 	TypeAtTerraformPath(context.Context, *tftypes.AttributePath) (attr.Type, error)
+
+	// EmptyValue should return an empty tftypes.Value of the schema's TerraformType
+	EmptyValue(context.Context) tftypes.Value
 }
 
 // SchemaApplyTerraform5AttributePathStep is a helper function to perform base
@@ -195,6 +198,19 @@ func SchemaTypeAtPath(ctx context.Context, s Schema, p path.Path) (attr.Type, di
 	return attrType, diags
 }
 
+func EmptySchemaValue(ctx context.Context, s Schema) tftypes.Value {
+	vals := make(map[string]tftypes.Value)
+	for name, attr := range s.GetAttributes() {
+		attr.GetType()
+		vals[name] = tftypes.NewValue(attr.GetType().TerraformType(ctx), nil)
+	}
+	for name, block := range s.GetBlocks() {
+		vals[name] = tftypes.NewValue(block.Type().TerraformType(ctx), nil)
+	}
+
+	return tftypes.NewValue(s.Type().TerraformType(ctx), vals)
+}
+
 // SchemaTypeAtTerraformPath is a helper function to perform base type handling
 // using the tftypes.AttributePathStepper interface.
 func SchemaTypeAtTerraformPath(ctx context.Context, s Schema, p *tftypes.AttributePath) (attr.Type, error) {