@@ -27,22 +27,22 @@ package suitable for distribution.
27
27
[ IDL ] : https://en.wikipedia.org/wiki/Interface_description_language
28
28
[ components ] : https://github.com/webassembly/component-model
29
29
30
- ## Package identifiers
30
+ ## Package Names
31
31
32
- All WIT packages are assigned an "ID". IDs look like ` foo:bar@1.0.0 ` and have
33
- three components :
32
+ All WIT packages are assigned a * package name * . Package names look like
33
+ ` foo:bar@1.0.0 ` and have three fields :
34
34
35
- * A namespace, for example ` foo ` in ` foo:bar ` . This namespace is intended to
36
- disambiguate between registries, top-level organizations, etc. For example
37
- WASI interfaces use the ` wasi ` namespace.
35
+ * A * namespace field * , for example ` foo ` in ` foo:bar ` . This namespace is
36
+ intended to disambiguate between registries, top-level organizations, etc.
37
+ For example WASI interfaces use the ` wasi ` namespace.
38
38
39
- * A package name , for example ` clocks ` in ` wasi:clocks ` . A package name groups
39
+ * A * package field * , for example ` clocks ` in ` wasi:clocks ` . A " package" groups
40
40
together a set of interfaces and worlds that would otherwise be named with a
41
41
common prefix.
42
42
43
- * An optional version, specified as [ full semver] ( https://semver.org/ ) .
43
+ * An optional * version field * , specified as [ full semver] ( https://semver.org/ ) .
44
44
45
- Package identifiers are specified at the top of a WIT file via a ` package `
45
+ Package names are specified at the top of a WIT file via a ` package `
46
46
declaration:
47
47
48
48
``` wit
@@ -56,11 +56,14 @@ package wasi:clocks@1.2.0;
56
56
```
57
57
58
58
WIT packages can be defined in a collection of files and at least one of them
59
- must specify a ` package ` identifier . Multiple files can specify a ` package ` and
60
- they must all agree on what the identifier is.
59
+ must specify a package name . Multiple files can specify a ` package ` and
60
+ they must all agree on what the package name is.
61
61
62
- Package identifiers are used to generate IDs in the component model binary
63
- format for [ ` interface ` s] [ interfaces ] and [ ` world ` s] [ worlds ] .
62
+ Package names are used to generate the [ names of imports and exports]
63
+ in the Component Model's representation of [ ` interface ` s] [ interfaces ] and
64
+ [ ` world ` s] [ worlds ] as described [ below] ( #package-format ) .
65
+
66
+ [ names of imports and exports ] : Explainer.md#import-and-export-definitions
64
67
65
68
## WIT Interfaces
66
69
[ interfaces ] : #wit-interfaces
0 commit comments