dart-sdk/pkg
Ömer Sinan Ağacan 636232628b [dart2wasm] Implement missing features in dynamic invocations
This reimplements dynamic call code generation to add support for type
checking, named parameters (optional and required), and fixes a few
related bugs on the way.

Currently we do not try to be as efficient as possible. The goal with
this patch is to implement it correctly.

Summary of the changes:

- For every dynamic access kind and member name, we generate a new
  "forwarder" function. Dynamic gets, sets, and invocations are compiled
  to calls to the forwarders with the right access kind (invocation,
  get, set) and member name.

  For example, if the program has dynamic invocation of a member "f", we
  create an "invocation forwarder for f". If it has a dynamic get of a
  member "x", we generate "getter forwarder for x".

- Forwarder functions take 4 arguments:

  - Receiver of the invocation, get, or set.

  - A Dart list for type arguments in the invocation. For gets and sets
    the list is empty.

  - A Dart list for positional arguments in the invocation. For gets the
    list is empty. For sets, the list only has one element.

  - A Dart list for named arguments. For gets and sets the list is
    empty. The list has alternating elements of type `Symbol` and
    `Object?`, for the name and value of the named parameters.

- A forwarder function compares receiver class ID with the potential
  targets of the call. When it finds a match, it compares the callee
  "shape" with the parameters passed in the call site.

  As it compares the shapes it adjusts argument lists:

  - Creates default values for missing optional positional and named
    arguments

  - Reorders the named argument list to match order expected by the
    callee

  If it can't find a matching class ID and a member with the right name
  and shape, it calls `noSuchMethod` on the receiver.

  If it finds a matching class ID and a member, it calls the "type
  checker" for the member, passing the original receiver and adjusted
  argument lists.

- A "type checker" implements argument type checking for a member, and
  it's a member of the same class as the member it's checking types
  for. This is to allow accessing class-bound type parameters when
  generating type checking code.

- Type checking is implemented using `_isSubtype` on arguments in the
  lists.

- When type checking is successful a type checker calls the original
  member, passing the arguments as expected by the member.

  If type checking is unsuccessful it throws a type error.

Most of the changes are for generating Wasm functions that compare
shapes, adjusts argument lists, and checks types.

Changes to members:

- `Translator.dynamics` fields is renamed to
  `Translator.dynamicForwarders`

- New field `Translator.dynamicForwarderFunctionType` added for the Wasm
  function type of forwarder and type checker functions.

- Two new code gen utilities added:

  - `Translator.indexList`: generates code that indexes a Dart list

  - `Translator.getListLength`: generates code that gets length of a
    Dart list

- New `Reference` extensions added to get type checker function
  references of members

- New runtime library `named_parameters` implements two helper functions
  for dealing with named argument lists

- The library `dynamic_dispatch` is replaced by `dynamic_forwarders`,
  which consists of two classes:

  - `DynamicForwarders`: maintains mapping from call kind (get, set,
    invocation) and member name to forwarder functions.

  - `Forwarder`: a single forwarder, implements code generation for
    forwarder functions.

- `CodeGenerator` gets 3 new members:

  - `_callForwader` generates call to a forwarder

  - `_generateFieldSetterTypeCheckerMethod` generates code for a type
    checker of a setter function.

  - `_generateProcedureTypeCheckerMethod` generates code for a type
    checker of a method.

Fixes #50367

Change-Id: I2b9d84237c8517bd217166d8acb67e025f0498fb
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/272261
Reviewed-by: Joshua Litt <joshualitt@google.com>
Commit-Queue: Ömer Ağacan <omersa@google.com>
Reviewed-by: Aske Simon Christensen <askesc@google.com>
2022-12-08 10:45:12 +00:00
..
_fe_analyzer_shared Patterns parsing: track when variable patterns are in an assignment context. 2022-12-07 22:45:40 +00:00
_js_interop_checks Reland "[pkg:js] Disallow using @staticInterop synthetic constructors" 2022-11-28 23:41:02 +00:00
analysis_server [analysis_server] fix RemoveDeadCode with forParts 2022-12-08 06:33:09 +00:00
analysis_server_client [analysis_server] Ensure plugin protocol classes only use types valid for Isolate.send() 2022-12-01 16:57:56 +00:00
analyzer [analyzer] Deduplicate strings in Declaration 2022-12-08 09:48:20 +00:00
analyzer_cli Enable new linter rules in analyzer packages 2022-11-21 23:02:38 +00:00
analyzer_plugin [analysis_server] Improve Snippet performance with caching and earlier filtering 2022-12-07 20:31:12 +00:00
analyzer_utilities analyzer_utilities: tidy static analysis 2022-11-28 18:11:03 +00:00
async_helper
build_integration
compiler [dart2js] Clean up migration interface 2022-12-08 04:17:51 +00:00
dart2js_info [dart2js:dump_info] put version and program info first... 2022-11-23 23:30:32 +00:00
dart2js_runtime_metrics
dart2js_tools
dart2native [3.0 alpha][VM/Runtime] - Flip flag to make strong null safety the default. 2022-12-06 04:04:23 +00:00
dart2wasm [dart2wasm] Implement missing features in dynamic invocations 2022-12-08 10:45:12 +00:00
dart_internal
dartdev [3.0 alpha][dart2js] No longer infer the null-safety mode from sources. 2022-12-07 04:02:13 +00:00
dds [deps] update package:webdriver 2022-12-01 17:42:21 +00:00
dds_service_extensions
dev_compiler [ddc] Add interop classes for static members 2022-12-08 04:57:50 +00:00
expect
front_end Patterns parsing: track when variable patterns are in an assignment context. 2022-12-07 22:45:40 +00:00
frontend_server [3.0 alpha][VM/Runtime] - Flip flag to make strong null safety the default. 2022-12-06 04:04:23 +00:00
js
js_ast [dart2js] Migrate ssa/codegen.dart 2022-11-16 21:32:00 +00:00
js_runtime [dart2js] loadLibrary priority annotation 2022-11-18 19:22:29 +00:00
js_shared
kernel [3.0 alpha][VM/Runtime] - Flip flag to make strong null safety the default. 2022-12-06 04:04:23 +00:00
language_versioning_2_7_test
meta
modular_test
native_stack_traces
nnbd_migration Add hints for Angular constructor arguments 2022-12-01 15:37:33 +00:00
scrape
smith
sourcemap_testing
status_file
telemetry
test_runner [3.0 alpha][VM/Runtime] - Flip flag to make strong null safety the default. 2022-12-06 04:04:23 +00:00
testing
vm [3.0 alpha][VM/Runtime] - Flip flag to make strong null safety the default. 2022-12-06 04:04:23 +00:00
vm_service [3.0 alpha] Bump version to 3.0.0 2022-12-06 02:40:36 +00:00
vm_snapshot_analysis
wasm_builder [dart2wasm] Add Wasm bottom heap types 2022-11-18 11:43:52 +00:00
.gitignore
BUILD.gn
OWNERS
pkg.status [pkg/dartdev] add windows support for 'dart bug' 2022-11-30 20:13:05 +00:00
README.md

Package validation

The packages in pkg/ are automatically validated on the LUCI CI bots. The validation is largely done by the tools/package_deps package; it can be tested locally via:

dart tools/package_deps/bin/package_deps.dart

Packages which are published

There are several packages developed in pkg/ which are published to pub. Validation of these packages is particularly important because the pub tools are not used for these packages during development; we get our dependency versions from the DEPS file. Its very easy for the dependencies specified in a package's pubspec file to get out of date wrt the packages and versions actually used.

In order to better ensure we're publishing correct packages, we validate some properties of the pubspec files on our CI system. These validations include:

  • that the dependencies listed in the pubspec are used in the package
  • that all the packages used by the source are listed in the pubspec
  • that we don't use relative path deps to pkg/ or third_party/ packages

Packages which are not published

For packages in pkg/ which we do not intend to be published, we put the following comment in the pubspec.yaml file:

# This package is not intended for consumption on pub.dev. DO NOT publish.
publish_to: none

These pubspecs are still validated by the package validation tool. The contents are more informational as the pubspecs for these packages are not consumed by the pub tool or ecosystem.

We validate:

  • that the dependencies listed in the pubspec are used in the package
  • that all the packages used by the source are listed in the pubspec
  • that a reference to a pkg/ package is done via a relative path dependency