polen 0.10.0-next.9 → 0.11.0-next.1

package/src/lib/graphql-change/change-groups.ts

@@ -0,0 +1,307 @@
+import { neverCase } from '@wollybeard/kit/language'
+import type {
+  Change,
+  DirectiveAddedChange,
+  DirectiveArgumentAddedChange,
+  DirectiveArgumentDefaultValueChangedChange,
+  DirectiveArgumentDescriptionChangedChange,
+  DirectiveArgumentRemovedChange,
+  DirectiveArgumentTypeChangedChange,
+  DirectiveDescriptionChangedChange,
+  DirectiveLocationAddedChange,
+  DirectiveLocationRemovedChange,
+  DirectiveRemovedChange,
+  DirectiveUsageArgumentDefinitionAddedChange,
+  DirectiveUsageArgumentDefinitionRemovedChange,
+  DirectiveUsageEnumAddedChange,
+  DirectiveUsageEnumRemovedChange,
+  DirectiveUsageEnumValueAddedChange,
+  DirectiveUsageEnumValueRemovedChange,
+  DirectiveUsageFieldAddedChange,
+  DirectiveUsageFieldDefinitionAddedChange,
+  DirectiveUsageFieldDefinitionRemovedChange,
+  DirectiveUsageFieldRemovedChange,
+  DirectiveUsageInputFieldDefinitionAddedChange,
+  DirectiveUsageInputFieldDefinitionRemovedChange,
+  DirectiveUsageInputObjectAddedChange,
+  DirectiveUsageInputObjectRemovedChange,
+  DirectiveUsageInterfaceAddedChange,
+  DirectiveUsageInterfaceRemovedChange,
+  DirectiveUsageObjectAddedChange,
+  DirectiveUsageObjectRemovedChange,
+  DirectiveUsageScalarAddedChange,
+  DirectiveUsageScalarRemovedChange,
+  DirectiveUsageSchemaAddedChange,
+  DirectiveUsageSchemaRemovedChange,
+  DirectiveUsageUnionMemberAddedChange,
+  DirectiveUsageUnionMemberRemovedChange,
+  EnumValueAddedChange,
+  EnumValueDeprecationReasonAddedChange,
+  EnumValueDeprecationReasonChangedChange,
+  EnumValueDeprecationReasonRemovedChange,
+  EnumValueDescriptionChangedChange,
+  EnumValueRemovedChange,
+  FieldAddedChange,
+  FieldArgumentAddedChange,
+  FieldArgumentDefaultChangedChange,
+  FieldArgumentDescriptionChangedChange,
+  FieldArgumentRemovedChange,
+  FieldArgumentTypeChangedChange,
+  FieldDeprecationAddedChange,
+  FieldDeprecationReasonAddedChange,
+  FieldDeprecationReasonChangedChange,
+  FieldDeprecationReasonRemovedChange,
+  FieldDeprecationRemovedChange,
+  FieldDescriptionAddedChange,
+  FieldDescriptionChangedChange,
+  FieldDescriptionRemovedChange,
+  FieldRemovedChange,
+  FieldTypeChangedChange,
+  InputFieldAddedChange,
+  InputFieldDefaultValueChangedChange,
+  InputFieldDescriptionAddedChange,
+  InputFieldDescriptionChangedChange,
+  InputFieldDescriptionRemovedChange,
+  InputFieldRemovedChange,
+  InputFieldTypeChangedChange,
+  ObjectTypeInterfaceAddedChange,
+  ObjectTypeInterfaceRemovedChange,
+  SchemaMutationTypeChangedChange,
+  SchemaQueryTypeChangedChange,
+  SchemaSubscriptionTypeChangedChange,
+  TypeAddedChange,
+  TypeDescriptionAddedChange,
+  TypeDescriptionChangedChange,
+  TypeDescriptionRemovedChange,
+  TypeKindChangedChange,
+  TypeRemovedChange,
+  UnionMemberAddedChange,
+  UnionMemberRemovedChange,
+} from './change-types.js'
+
+// Type operations
+export type TypeOperation = TypeAddedChange | TypeRemovedChange | TypeKindChangedChange
+export const isTypeOperation = (change: Change): change is TypeOperation =>
+  change.type === `TYPE_ADDED` || change.type === `TYPE_REMOVED` || change.type === `TYPE_KIND_CHANGED`
+
+// Type descriptions
+export type TypeDescription = TypeDescriptionAddedChange | TypeDescriptionRemovedChange | TypeDescriptionChangedChange
+export const isTypeDescription = (change: Change): change is TypeDescription =>
+  change.type === `TYPE_DESCRIPTION_ADDED` || change.type === `TYPE_DESCRIPTION_REMOVED`
+  || change.type === `TYPE_DESCRIPTION_CHANGED`
+
+// Field operations
+export type FieldOperation = FieldAddedChange | FieldRemovedChange | FieldTypeChangedChange
+export const isFieldOperation = (change: Change): change is FieldOperation =>
+  change.type === `FIELD_ADDED` || change.type === `FIELD_REMOVED` || change.type === `FIELD_TYPE_CHANGED`
+
+// Field descriptions
+export type FieldDescription =
+  | FieldDescriptionAddedChange
+  | FieldDescriptionRemovedChange
+  | FieldDescriptionChangedChange
+export const isFieldDescription = (change: Change): change is FieldDescription =>
+  change.type === `FIELD_DESCRIPTION_ADDED` || change.type === `FIELD_DESCRIPTION_REMOVED`
+  || change.type === `FIELD_DESCRIPTION_CHANGED`
+
+// Field deprecation
+export type FieldDeprecation = FieldDeprecationAddedChange | FieldDeprecationRemovedChange
+export const isFieldDeprecation = (change: Change): change is FieldDeprecation =>
+  change.type === `FIELD_DEPRECATION_ADDED` || change.type === `FIELD_DEPRECATION_REMOVED`
+
+// Field deprecation reason
+export type FieldDeprecationReason =
+  | FieldDeprecationReasonAddedChange
+  | FieldDeprecationReasonRemovedChange
+  | FieldDeprecationReasonChangedChange
+export const isFieldDeprecationReason = (change: Change): change is FieldDeprecationReason =>
+  change.type === `FIELD_DEPRECATION_REASON_ADDED` || change.type === `FIELD_DEPRECATION_REASON_REMOVED`
+  || change.type === `FIELD_DEPRECATION_REASON_CHANGED`
+
+// Field argument operations
+export type FieldArgumentOperation = FieldArgumentAddedChange | FieldArgumentRemovedChange
+export const isFieldArgumentOperation = (change: Change): change is FieldArgumentOperation =>
+  change.type === `FIELD_ARGUMENT_ADDED` || change.type === `FIELD_ARGUMENT_REMOVED`
+
+// Field argument changes
+export type FieldArgument = FieldArgumentDefaultChangedChange | FieldArgumentTypeChangedChange
+export const isFieldArgument = (change: Change): change is FieldArgument =>
+  change.type === `FIELD_ARGUMENT_DEFAULT_CHANGED` || change.type === `FIELD_ARGUMENT_TYPE_CHANGED`
+
+// Field argument description
+export type FieldArgumentDescription = FieldArgumentDescriptionChangedChange
+export const isFieldArgumentDescription = (change: Change): change is FieldArgumentDescription =>
+  change.type === `FIELD_ARGUMENT_DESCRIPTION_CHANGED`
+
+// Enum value operations
+export type EnumValueOperation = EnumValueAddedChange | EnumValueRemovedChange
+export const isEnumValueOperation = (change: Change): change is EnumValueOperation =>
+  change.type === `ENUM_VALUE_ADDED` || change.type === `ENUM_VALUE_REMOVED`
+
+// Enum value description
+export type EnumValueDescription = EnumValueDescriptionChangedChange
+export const isEnumValueDescription = (change: Change): change is EnumValueDescription =>
+  change.type === `ENUM_VALUE_DESCRIPTION_CHANGED`
+
+// Enum value deprecation reason
+export type EnumValueDeprecationReason =
+  | EnumValueDeprecationReasonAddedChange
+  | EnumValueDeprecationReasonRemovedChange
+  | EnumValueDeprecationReasonChangedChange
+export const isEnumValueDeprecationReason = (change: Change): change is EnumValueDeprecationReason =>
+  change.type === `ENUM_VALUE_DEPRECATION_REASON_ADDED` || change.type === `ENUM_VALUE_DEPRECATION_REASON_REMOVED`
+  || change.type === `ENUM_VALUE_DEPRECATION_REASON_CHANGED`
+
+// Input field operations
+export type InputFieldOperation = InputFieldAddedChange | InputFieldRemovedChange | InputFieldTypeChangedChange
+export const isInputFieldOperation = (change: Change): change is InputFieldOperation =>
+  change.type === `INPUT_FIELD_ADDED` || change.type === `INPUT_FIELD_REMOVED`
+  || change.type === `INPUT_FIELD_TYPE_CHANGED`
+
+// Input field descriptions
+export type InputFieldDescription =
+  | InputFieldDescriptionAddedChange
+  | InputFieldDescriptionRemovedChange
+  | InputFieldDescriptionChangedChange
+export const isInputFieldDescription = (change: Change): change is InputFieldDescription =>
+  change.type === `INPUT_FIELD_DESCRIPTION_ADDED` || change.type === `INPUT_FIELD_DESCRIPTION_REMOVED`
+  || change.type === `INPUT_FIELD_DESCRIPTION_CHANGED`
+
+// Input field default value
+export type InputFieldDefaultValue = InputFieldDefaultValueChangedChange
+export const isInputFieldDefaultValue = (change: Change): change is InputFieldDefaultValue =>
+  change.type === `INPUT_FIELD_DEFAULT_VALUE_CHANGED`
+
+// Union member operations
+export type UnionMemberOperation = UnionMemberAddedChange | UnionMemberRemovedChange
+export const isUnionMemberOperation = (change: Change): change is UnionMemberOperation =>
+  change.type === `UNION_MEMBER_ADDED` || change.type === `UNION_MEMBER_REMOVED`
+
+// Object type interface operations
+export type ObjectTypeInterfaceOperation = ObjectTypeInterfaceAddedChange | ObjectTypeInterfaceRemovedChange
+export const isObjectTypeInterfaceOperation = (change: Change): change is ObjectTypeInterfaceOperation =>
+  change.type === `OBJECT_TYPE_INTERFACE_ADDED` || change.type === `OBJECT_TYPE_INTERFACE_REMOVED`
+
+// Directive operations
+export type DirectiveOperation = DirectiveAddedChange | DirectiveRemovedChange
+export const isDirectiveOperation = (change: Change): change is DirectiveOperation =>
+  change.type === `DIRECTIVE_ADDED` || change.type === `DIRECTIVE_REMOVED`
+
+// Directive description
+export type DirectiveDescription = DirectiveDescriptionChangedChange
+export const isDirectiveDescription = (change: Change): change is DirectiveDescription =>
+  change.type === `DIRECTIVE_DESCRIPTION_CHANGED`
+
+// Directive location operations
+export type DirectiveLocationOperation = DirectiveLocationAddedChange | DirectiveLocationRemovedChange
+export const isDirectiveLocationOperation = (change: Change): change is DirectiveLocationOperation =>
+  change.type === `DIRECTIVE_LOCATION_ADDED` || change.type === `DIRECTIVE_LOCATION_REMOVED`
+
+// Directive argument operations
+export type DirectiveArgumentOperation = DirectiveArgumentAddedChange | DirectiveArgumentRemovedChange
+export const isDirectiveArgumentOperation = (change: Change): change is DirectiveArgumentOperation =>
+  change.type === `DIRECTIVE_ARGUMENT_ADDED` || change.type === `DIRECTIVE_ARGUMENT_REMOVED`
+
+// Directive argument changes
+export type DirectiveArgument = DirectiveArgumentDefaultValueChangedChange | DirectiveArgumentTypeChangedChange
+export const isDirectiveArgument = (change: Change): change is DirectiveArgument =>
+  change.type === `DIRECTIVE_ARGUMENT_DEFAULT_VALUE_CHANGED` || change.type === `DIRECTIVE_ARGUMENT_TYPE_CHANGED`
+
+// Directive argument description
+export type DirectiveArgumentDescription = DirectiveArgumentDescriptionChangedChange
+export const isDirectiveArgumentDescription = (change: Change): change is DirectiveArgumentDescription =>
+  change.type === `DIRECTIVE_ARGUMENT_DESCRIPTION_CHANGED`
+
+// Schema root type changes
+export type SchemaRootType =
+  | SchemaQueryTypeChangedChange
+  | SchemaMutationTypeChangedChange
+  | SchemaSubscriptionTypeChangedChange
+export const isSchemaRootType = (change: Change): change is SchemaRootType =>
+  change.type === `SCHEMA_QUERY_TYPE_CHANGED` || change.type === `SCHEMA_MUTATION_TYPE_CHANGED`
+  || change.type === `SCHEMA_SUBSCRIPTION_TYPE_CHANGED`
+
+// Directive usage changes
+export type DirectiveUsage =
+  | DirectiveUsageUnionMemberAddedChange
+  | DirectiveUsageUnionMemberRemovedChange
+  | DirectiveUsageEnumAddedChange
+  | DirectiveUsageEnumRemovedChange
+  | DirectiveUsageEnumValueAddedChange
+  | DirectiveUsageEnumValueRemovedChange
+  | DirectiveUsageInputObjectAddedChange
+  | DirectiveUsageInputObjectRemovedChange
+  | DirectiveUsageFieldAddedChange
+  | DirectiveUsageFieldRemovedChange
+  | DirectiveUsageScalarAddedChange
+  | DirectiveUsageScalarRemovedChange
+  | DirectiveUsageObjectAddedChange
+  | DirectiveUsageObjectRemovedChange
+  | DirectiveUsageInterfaceAddedChange
+  | DirectiveUsageInterfaceRemovedChange
+  | DirectiveUsageArgumentDefinitionAddedChange
+  | DirectiveUsageArgumentDefinitionRemovedChange
+  | DirectiveUsageSchemaAddedChange
+  | DirectiveUsageSchemaRemovedChange
+  | DirectiveUsageFieldDefinitionAddedChange
+  | DirectiveUsageFieldDefinitionRemovedChange
+  | DirectiveUsageInputFieldDefinitionAddedChange
+  | DirectiveUsageInputFieldDefinitionRemovedChange
+
+export const isDirectiveUsage = (change: Change): change is DirectiveUsage => change.type.startsWith(`DIRECTIVE_USAGE_`)
+
+export type Type =
+  | 'TypeOperation'
+  | 'TypeDescription'
+  | 'FieldOperation'
+  | 'FieldDescription'
+  | 'FieldDeprecation'
+  | 'FieldDeprecationReason'
+  | 'FieldArgumentOperation'
+  | 'FieldArgument'
+  | 'FieldArgumentDescription'
+  | 'EnumValueOperation'
+  | 'EnumValueDescription'
+  | 'EnumValueDeprecationReason'
+  | 'InputFieldOperation'
+  | 'InputFieldDescription'
+  | 'InputFieldDefaultValue'
+  | 'UnionMemberOperation'
+  | 'ObjectTypeInterfaceOperation'
+  | 'DirectiveOperation'
+  | 'DirectiveDescription'
+  | 'DirectiveLocationOperation'
+  | 'DirectiveArgumentOperation'
+  | 'DirectiveArgument'
+  | 'DirectiveArgumentDescription'
+  | 'SchemaRootType'
+  | 'DirectiveUsage'
+
+export const getType = (change: Change): Type => {
+  if (isTypeOperation(change)) return 'TypeOperation'
+  if (isTypeDescription(change)) return 'TypeDescription'
+  if (isFieldOperation(change)) return 'FieldOperation'
+  if (isFieldDescription(change)) return 'FieldDescription'
+  if (isFieldDeprecation(change)) return 'FieldDeprecation'
+  if (isFieldDeprecationReason(change)) return 'FieldDeprecationReason'
+  if (isFieldArgumentOperation(change)) return 'FieldArgumentOperation'
+  if (isFieldArgument(change)) return 'FieldArgument'
+  if (isFieldArgumentDescription(change)) return 'FieldArgumentDescription'
+  if (isEnumValueOperation(change)) return 'EnumValueOperation'
+  if (isEnumValueDescription(change)) return 'EnumValueDescription'
+  if (isEnumValueDeprecationReason(change)) return 'EnumValueDeprecationReason'
+  if (isInputFieldOperation(change)) return 'InputFieldOperation'
+  if (isInputFieldDescription(change)) return 'InputFieldDescription'
+  if (isInputFieldDefaultValue(change)) return 'InputFieldDefaultValue'
+  if (isUnionMemberOperation(change)) return 'UnionMemberOperation'
+  if (isObjectTypeInterfaceOperation(change)) return 'ObjectTypeInterfaceOperation'
+  if (isDirectiveOperation(change)) return 'DirectiveOperation'
+  if (isDirectiveDescription(change)) return 'DirectiveDescription'
+  if (isDirectiveLocationOperation(change)) return 'DirectiveLocationOperation'
+  if (isDirectiveArgumentOperation(change)) return 'DirectiveArgumentOperation'
+  if (isDirectiveArgument(change)) return 'DirectiveArgument'
+  if (isDirectiveArgumentDescription(change)) return 'DirectiveArgumentDescription'
+  if (isSchemaRootType(change)) return 'SchemaRootType'
+  if (isDirectiveUsage(change)) return 'DirectiveUsage'
+  neverCase(change)
+}

package/src/lib/graphql-change/change-types.ts

@@ -0,0 +1,203 @@
+// dprint-ignore-file
+import type { GraphqlInspector } from '#dep/graphql-inspector/index'
+
+/**
+ * Additional properties that Polen adds to GraphQL Inspector changes
+ */
+export interface ChangeExtensions {
+  message: string
+  path?: string
+  criticality: GraphqlInspector.Core.Criticality
+}
+
+// Type changes
+export interface TypeAddedChange extends GraphqlInspector.Core.TypeAddedChange, ChangeExtensions {}
+export interface TypeRemovedChange extends GraphqlInspector.Core.TypeRemovedChange, ChangeExtensions {}
+export interface TypeKindChangedChange extends GraphqlInspector.Core.TypeKindChangedChange, ChangeExtensions {}
+export interface TypeDescriptionChangedChange extends GraphqlInspector.Core.TypeDescriptionChangedChange, ChangeExtensions {}
+export interface TypeDescriptionAddedChange extends GraphqlInspector.Core.TypeDescriptionAddedChange, ChangeExtensions {}
+export interface TypeDescriptionRemovedChange extends GraphqlInspector.Core.TypeDescriptionRemovedChange, ChangeExtensions {}
+
+// Field changes
+export interface FieldAddedChange extends GraphqlInspector.Core.FieldAddedChange, ChangeExtensions {}
+export interface FieldRemovedChange extends GraphqlInspector.Core.FieldRemovedChange, ChangeExtensions {}
+export interface FieldTypeChangedChange extends GraphqlInspector.Core.FieldTypeChangedChange, ChangeExtensions {}
+// Note: GraphQL Inspector doesn't have FieldDeprecatedChange, it's handled by FieldDeprecationAddedChange
+export interface FieldDeprecationAddedChange extends GraphqlInspector.Core.FieldDeprecationAddedChange, ChangeExtensions {}
+export interface FieldDeprecationRemovedChange extends GraphqlInspector.Core.FieldDeprecationRemovedChange, ChangeExtensions {}
+export interface FieldDeprecationReasonChangedChange extends GraphqlInspector.Core.FieldDeprecationReasonChangedChange, ChangeExtensions {}
+export interface FieldDeprecationReasonAddedChange extends GraphqlInspector.Core.FieldDeprecationReasonAddedChange, ChangeExtensions {}
+export interface FieldDeprecationReasonRemovedChange extends GraphqlInspector.Core.FieldDeprecationReasonRemovedChange, ChangeExtensions {}
+export interface FieldDescriptionChangedChange extends GraphqlInspector.Core.FieldDescriptionChangedChange, ChangeExtensions {}
+export interface FieldDescriptionAddedChange extends GraphqlInspector.Core.FieldDescriptionAddedChange, ChangeExtensions {}
+export interface FieldDescriptionRemovedChange extends GraphqlInspector.Core.FieldDescriptionRemovedChange, ChangeExtensions {}
+
+// Field argument changes
+export interface FieldArgumentAddedChange extends GraphqlInspector.Core.FieldArgumentAddedChange, ChangeExtensions {}
+export interface FieldArgumentRemovedChange extends GraphqlInspector.Core.FieldArgumentRemovedChange, ChangeExtensions {}
+export interface FieldArgumentTypeChangedChange extends GraphqlInspector.Core.FieldArgumentTypeChangedChange, ChangeExtensions {}
+export interface FieldArgumentDescriptionChangedChange extends GraphqlInspector.Core.FieldArgumentDescriptionChangedChange, ChangeExtensions {}
+export interface FieldArgumentDefaultChangedChange extends GraphqlInspector.Core.FieldArgumentDefaultChangedChange, ChangeExtensions {}
+
+// Enum changes
+export interface EnumValueAddedChange extends GraphqlInspector.Core.EnumValueAddedChange, ChangeExtensions {}
+export interface EnumValueRemovedChange extends GraphqlInspector.Core.EnumValueRemovedChange, ChangeExtensions {}
+export interface EnumValueDescriptionChangedChange extends GraphqlInspector.Core.EnumValueDescriptionChangedChange, ChangeExtensions {}
+export interface EnumValueDeprecationReasonAddedChange extends GraphqlInspector.Core.EnumValueDeprecationReasonAddedChange, ChangeExtensions {}
+export interface EnumValueDeprecationReasonChangedChange extends GraphqlInspector.Core.EnumValueDeprecationReasonChangedChange, ChangeExtensions {}
+export interface EnumValueDeprecationReasonRemovedChange extends GraphqlInspector.Core.EnumValueDeprecationReasonRemovedChange, ChangeExtensions {}
+
+// Input field changes
+export interface InputFieldAddedChange extends GraphqlInspector.Core.InputFieldAddedChange, ChangeExtensions {}
+export interface InputFieldRemovedChange extends GraphqlInspector.Core.InputFieldRemovedChange, ChangeExtensions {}
+export interface InputFieldTypeChangedChange extends GraphqlInspector.Core.InputFieldTypeChangedChange, ChangeExtensions {}
+export interface InputFieldDescriptionAddedChange extends GraphqlInspector.Core.InputFieldDescriptionAddedChange, ChangeExtensions {}
+export interface InputFieldDescriptionRemovedChange extends GraphqlInspector.Core.InputFieldDescriptionRemovedChange, ChangeExtensions {}
+export interface InputFieldDescriptionChangedChange extends GraphqlInspector.Core.InputFieldDescriptionChangedChange, ChangeExtensions {}
+export interface InputFieldDefaultValueChangedChange extends GraphqlInspector.Core.InputFieldDefaultValueChangedChange, ChangeExtensions {}
+
+// Union changes
+export interface UnionMemberAddedChange extends GraphqlInspector.Core.UnionMemberAddedChange, ChangeExtensions {}
+export interface UnionMemberRemovedChange extends GraphqlInspector.Core.UnionMemberRemovedChange, ChangeExtensions {}
+
+// Interface changes
+export interface ObjectTypeInterfaceAddedChange extends GraphqlInspector.Core.ObjectTypeInterfaceAddedChange, ChangeExtensions {}
+export interface ObjectTypeInterfaceRemovedChange extends GraphqlInspector.Core.ObjectTypeInterfaceRemovedChange, ChangeExtensions {}
+
+// Directive changes
+export interface DirectiveAddedChange extends GraphqlInspector.Core.DirectiveAddedChange, ChangeExtensions {}
+export interface DirectiveRemovedChange extends GraphqlInspector.Core.DirectiveRemovedChange, ChangeExtensions {}
+export interface DirectiveDescriptionChangedChange extends GraphqlInspector.Core.DirectiveDescriptionChangedChange, ChangeExtensions {}
+export interface DirectiveLocationAddedChange extends GraphqlInspector.Core.DirectiveLocationAddedChange, ChangeExtensions {}
+export interface DirectiveLocationRemovedChange extends GraphqlInspector.Core.DirectiveLocationRemovedChange, ChangeExtensions {}
+export interface DirectiveArgumentAddedChange extends GraphqlInspector.Core.DirectiveArgumentAddedChange, ChangeExtensions {}
+export interface DirectiveArgumentRemovedChange extends GraphqlInspector.Core.DirectiveArgumentRemovedChange, ChangeExtensions {}
+export interface DirectiveArgumentDescriptionChangedChange extends GraphqlInspector.Core.DirectiveArgumentDescriptionChangedChange, ChangeExtensions {}
+export interface DirectiveArgumentDefaultValueChangedChange extends GraphqlInspector.Core.DirectiveArgumentDefaultValueChangedChange, ChangeExtensions {}
+export interface DirectiveArgumentTypeChangedChange extends GraphqlInspector.Core.DirectiveArgumentTypeChangedChange, ChangeExtensions {}
+
+// Schema changes
+export interface SchemaQueryTypeChangedChange extends GraphqlInspector.Core.SchemaQueryTypeChangedChange, ChangeExtensions {}
+export interface SchemaMutationTypeChangedChange extends GraphqlInspector.Core.SchemaMutationTypeChangedChange, ChangeExtensions {}
+export interface SchemaSubscriptionTypeChangedChange extends GraphqlInspector.Core.SchemaSubscriptionTypeChangedChange, ChangeExtensions {}
+
+// Directive usage changes
+export interface DirectiveUsageUnionMemberAddedChange extends GraphqlInspector.Core.DirectiveUsageUnionMemberAddedChange, ChangeExtensions {}
+export interface DirectiveUsageUnionMemberRemovedChange extends GraphqlInspector.Core.DirectiveUsageUnionMemberRemovedChange, ChangeExtensions {}
+export interface DirectiveUsageEnumAddedChange extends GraphqlInspector.Core.DirectiveUsageEnumAddedChange, ChangeExtensions {}
+export interface DirectiveUsageEnumRemovedChange extends GraphqlInspector.Core.DirectiveUsageEnumRemovedChange, ChangeExtensions {}
+export interface DirectiveUsageEnumValueAddedChange extends GraphqlInspector.Core.DirectiveUsageEnumValueAddedChange, ChangeExtensions {}
+export interface DirectiveUsageEnumValueRemovedChange extends GraphqlInspector.Core.DirectiveUsageEnumValueRemovedChange, ChangeExtensions {}
+export interface DirectiveUsageInputObjectAddedChange extends GraphqlInspector.Core.DirectiveUsageInputObjectAddedChange, ChangeExtensions {}
+export interface DirectiveUsageInputObjectRemovedChange extends GraphqlInspector.Core.DirectiveUsageInputObjectRemovedChange, ChangeExtensions {}
+export interface DirectiveUsageFieldAddedChange extends GraphqlInspector.Core.DirectiveUsageFieldAddedChange, ChangeExtensions {}
+export interface DirectiveUsageFieldRemovedChange extends GraphqlInspector.Core.DirectiveUsageFieldRemovedChange, ChangeExtensions {}
+export interface DirectiveUsageScalarAddedChange extends GraphqlInspector.Core.DirectiveUsageScalarAddedChange, ChangeExtensions {}
+export interface DirectiveUsageScalarRemovedChange extends GraphqlInspector.Core.DirectiveUsageScalarRemovedChange, ChangeExtensions {}
+export interface DirectiveUsageObjectAddedChange extends GraphqlInspector.Core.DirectiveUsageObjectAddedChange, ChangeExtensions {}
+export interface DirectiveUsageObjectRemovedChange extends GraphqlInspector.Core.DirectiveUsageObjectRemovedChange, ChangeExtensions {}
+export interface DirectiveUsageInterfaceAddedChange extends GraphqlInspector.Core.DirectiveUsageInterfaceAddedChange, ChangeExtensions {}
+export interface DirectiveUsageInterfaceRemovedChange extends GraphqlInspector.Core.DirectiveUsageInterfaceRemovedChange, ChangeExtensions {}
+export interface DirectiveUsageArgumentDefinitionAddedChange extends GraphqlInspector.Core.DirectiveUsageArgumentDefinitionAddedChange, ChangeExtensions {}
+export interface DirectiveUsageArgumentDefinitionRemovedChange extends GraphqlInspector.Core.DirectiveUsageArgumentDefinitionRemovedChange, ChangeExtensions {}
+export interface DirectiveUsageSchemaAddedChange extends GraphqlInspector.Core.DirectiveUsageSchemaAddedChange, ChangeExtensions {}
+export interface DirectiveUsageSchemaRemovedChange extends GraphqlInspector.Core.DirectiveUsageSchemaRemovedChange, ChangeExtensions {}
+export interface DirectiveUsageFieldDefinitionAddedChange extends GraphqlInspector.Core.DirectiveUsageFieldDefinitionAddedChange, ChangeExtensions {}
+export interface DirectiveUsageFieldDefinitionRemovedChange extends GraphqlInspector.Core.DirectiveUsageFieldDefinitionRemovedChange, ChangeExtensions {}
+export interface DirectiveUsageInputFieldDefinitionAddedChange extends GraphqlInspector.Core.DirectiveUsageInputFieldDefinitionAddedChange, ChangeExtensions {}
+export interface DirectiveUsageInputFieldDefinitionRemovedChange extends GraphqlInspector.Core.DirectiveUsageInputFieldDefinitionRemovedChange, ChangeExtensions {}
+
+/**
+ * Discriminated union of all possible change types
+ */
+export type Change =
+  | TypeAddedChange
+  | TypeRemovedChange
+  | TypeKindChangedChange
+  | TypeDescriptionChangedChange
+  | TypeDescriptionAddedChange
+  | TypeDescriptionRemovedChange
+  | FieldAddedChange
+  | FieldRemovedChange
+  | FieldTypeChangedChange
+  // | FieldDeprecatedChange
+  | FieldDeprecationAddedChange
+  | FieldDeprecationRemovedChange
+  | FieldDeprecationReasonChangedChange
+  | FieldDeprecationReasonAddedChange
+  | FieldDeprecationReasonRemovedChange
+  | FieldDescriptionChangedChange
+  | FieldDescriptionAddedChange
+  | FieldDescriptionRemovedChange
+  | FieldArgumentAddedChange
+  | FieldArgumentRemovedChange
+  | FieldArgumentTypeChangedChange
+  | FieldArgumentDescriptionChangedChange
+  | FieldArgumentDefaultChangedChange
+  | EnumValueAddedChange
+  | EnumValueRemovedChange
+  | EnumValueDescriptionChangedChange
+  | EnumValueDeprecationReasonAddedChange
+  | EnumValueDeprecationReasonChangedChange
+  | EnumValueDeprecationReasonRemovedChange
+  | InputFieldAddedChange
+  | InputFieldRemovedChange
+  | InputFieldTypeChangedChange
+  | InputFieldDescriptionAddedChange
+  | InputFieldDescriptionRemovedChange
+  | InputFieldDescriptionChangedChange
+  | InputFieldDefaultValueChangedChange
+  | UnionMemberAddedChange
+  | UnionMemberRemovedChange
+  | ObjectTypeInterfaceAddedChange
+  | ObjectTypeInterfaceRemovedChange
+  | DirectiveAddedChange
+  | DirectiveRemovedChange
+  | DirectiveDescriptionChangedChange
+  | DirectiveLocationAddedChange
+  | DirectiveLocationRemovedChange
+  | DirectiveArgumentAddedChange
+  | DirectiveArgumentRemovedChange
+  | DirectiveArgumentDescriptionChangedChange
+  | DirectiveArgumentDefaultValueChangedChange
+  | DirectiveArgumentTypeChangedChange
+  | SchemaQueryTypeChangedChange
+  | SchemaMutationTypeChangedChange
+  | SchemaSubscriptionTypeChangedChange
+  | DirectiveUsageUnionMemberAddedChange
+  | DirectiveUsageUnionMemberRemovedChange
+  | DirectiveUsageEnumAddedChange
+  | DirectiveUsageEnumRemovedChange
+  | DirectiveUsageEnumValueAddedChange
+  | DirectiveUsageEnumValueRemovedChange
+  | DirectiveUsageInputObjectAddedChange
+  | DirectiveUsageInputObjectRemovedChange
+  | DirectiveUsageFieldAddedChange
+  | DirectiveUsageFieldRemovedChange
+  | DirectiveUsageScalarAddedChange
+  | DirectiveUsageScalarRemovedChange
+  | DirectiveUsageObjectAddedChange
+  | DirectiveUsageObjectRemovedChange
+  | DirectiveUsageInterfaceAddedChange
+  | DirectiveUsageInterfaceRemovedChange
+  | DirectiveUsageArgumentDefinitionAddedChange
+  | DirectiveUsageArgumentDefinitionRemovedChange
+  | DirectiveUsageSchemaAddedChange
+  | DirectiveUsageSchemaRemovedChange
+  | DirectiveUsageFieldDefinitionAddedChange
+  | DirectiveUsageFieldDefinitionRemovedChange
+  | DirectiveUsageInputFieldDefinitionAddedChange
+  | DirectiveUsageInputFieldDefinitionRemovedChange
+
+/**
+ * Type guard to check if a value is a valid Change
+ */
+export const isChange = (value: unknown): value is Change => {
+  return (
+    typeof value === 'object' &&
+    value !== null &&
+    'type' in value &&
+    'criticality' in value &&
+    'message' in value
+  )
+}

package/src/lib/graphql-change/criticality.ts

@@ -0,0 +1,45 @@
+import { CriticalityLevel } from '@graphql-inspector/core'
+import type { BadgeProps } from '@radix-ui/themes'
+import type { Change } from './change-types.js'
+
+export { CriticalityLevel } from '@graphql-inspector/core'
+
+// Type guard functions
+export const isCriticalityBreaking = (change: Change): boolean => change.criticality.level === CriticalityLevel.Breaking
+
+export const isCriticalityDangerous = (change: Change): boolean =>
+  change.criticality.level === CriticalityLevel.Dangerous
+
+export const isCriticalitySafe = (change: Change): boolean => change.criticality.level === CriticalityLevel.NonBreaking
+
+/** Ordered array for iteration (from most to least critical) */
+export const CRITICALITY_LEVELS = [
+  CriticalityLevel.Breaking,
+  CriticalityLevel.Dangerous,
+  CriticalityLevel.NonBreaking,
+] as const
+
+// Config for UI display
+interface CriticalityConfig {
+  color: Exclude<BadgeProps['color'], undefined>
+  label: string
+  shortLabel: string
+}
+
+export const CRITICALITY_CONFIG = {
+  [CriticalityLevel.Breaking]: {
+    color: 'red',
+    label: 'Breaking Changes',
+    shortLabel: 'Breaking',
+  },
+  [CriticalityLevel.Dangerous]: {
+    color: 'yellow',
+    label: 'Dangerous Changes',
+    shortLabel: 'Dangerous',
+  },
+  [CriticalityLevel.NonBreaking]: {
+    color: 'green',
+    label: 'Safe Changes',
+    shortLabel: 'Safe',
+  },
+} satisfies Record<CriticalityLevel, CriticalityConfig>

package/src/lib/graphql-change/graphql-change.ts

@@ -1,11 +1,13 @@
 import { GraphqlInspector } from '#dep/graphql-inspector/index'
 import type { GrafaidOld } from '#lib/grafaid-old/index'
+import type { Change } from './change-types.js'
 
-export type Change = GraphqlInspector.Core.SerializableChange & {
-  message: string
-  path?: string
-  criticality: GraphqlInspector.Core.Criticality
-}
+export * from './change-types.js'
+
+export * from './criticality.js'
+
+import * as Group from './change-groups.js'
+export { Group }
 
 export const calcChangeset = async (parameters: {
   after: GrafaidOld.Schema.Schema

package/src/lib/graphql-change/index.ts

@@ -1 +1 @@
-export * as GraphqlChange from './graphql-change.ts'
+export * as GraphqlChange from './graphql-change.js'

package/src/lib/graphql-changeset/index.ts

@@ -1 +1 @@
-export * as GraphqlChangeset from './graphql-changeset.ts'
+export * as GraphqlChangeset from './graphql-changeset.js'

package/src/lib/graphql-schema-loader/index.ts

@@ -1 +1 @@
-export * as GraphqlSchemaLoader from './graphql-schema-loader.ts'
+export * as GraphqlSchemaLoader from './graphql-schema-loader.js'

package/src/lib/helpers.ts

@@ -10,7 +10,7 @@ export async function checkIsProjectHasPackageInstalled(
   const packageJson = await Manifest.resource.read(projectRoot)
 
   if (Err.is(packageJson)) {
-    if (packageJson._tag === 'ResourceErrorNotFound') return false
+    if (packageJson._tag === `ResourceErrorNotFound`) return false
     throw packageJson
   }
 

package/src/lib/hono-aid/index.ts

@@ -1 +1 @@
-export * as HonoAid from './hono-aid.ts'
+export * as HonoAid from './hono-aid.js'

package/src/lib/html-utils/html-transformer.ts

@@ -0,0 +1,6 @@
+import type { Hono } from '#dep/hono/index'
+import { Fn } from '@wollybeard/kit'
+
+export type HtmlTransformer = (html: string, ctx: Hono.Context) => Promise<string> | string
+
+export const createHtmlTransformer = Fn.identity<HtmlTransformer>