visibility design and discussion

.gitignore

@@ -0,0 +1,5 @@
+# macOS
+.DS_Store
+
+# vi temp files
+*.swp

COPYRIGHT

@@ -1,11 +1,11 @@
-Copyright (c) The wgsl-tooling-wg Contributors.
+Copyright (c) The webgpu-tools Contributors.
 
-Copyrights in the wgsl-tooling-wg projects are retained by their contributors.
-No copyright assignment is required to contribute to the wgsl-tooling-wg projects.
+Copyrights in the webgpu-tools projects are retained by their contributors.
+No copyright assignment is required to contribute to the webgpu-tools projects.
 
 Some files include explicit copyright notices and/or license notices.
 For full authorship information, see the version control history.
 
-Except as otherwise noted, the wgsl-tooling-wg projects are licensed under the
+Except as otherwise noted, the webgpu-tools projects are licensed under the
 Apache License, Version 2.0 <LICENSE-APACHE> or <http://www.apache.org/licenses/LICENSE-2.0>
 or the MIT license <LICENSE-MIT> or <http://opensource.org/licenses/MIT>, at your option.

ConditionalTranslation.md

@@ -114,7 +114,7 @@ Refer to the [updated grammar appendix](#appendix-updated-grammar) for the list
    * const assertion statements
 
 > [!WARNING]
-> We added attributes on assignment and increment/decrement statements. This change makes the WESL grammar no longer [LR(1)](https://en.wikipedia.org/wiki/LR_parser). See [`wesl-rs#162`](https://github.com/wgsl-tooling-wg/wesl-rs/issues/162) for details.
+> We added attributes on assignment and increment/decrement statements. This change makes the WESL grammar no longer [LR(1)](https://en.wikipedia.org/wiki/LR_parser). See [`wesl-rs#162`](https://github.com/webgpu-tools/wesl-rs/issues/162) for details.
 >
 > Due to this limitation, *wesl-rs* does not allow attributes on assignment, increment and decrement statements starting with a `(`. Concretely, this is not supported by *wesl-rs*: `@if(FOO) (x)++`.
 

GLOSSARY.md

@@ -12,9 +12,13 @@
   * Type aliases
   * [Const declarations, override declarations](https://www.w3.org/TR/WGSL/#value-decls)
   * [Var declarations](https://www.w3.org/TR/WGSL/#var-decls)
-* **Module**: A single WESL or WGSL file.
+* **Module**: A unit of WESL or WGSL code with its own top-level scope, stored in a single module source.
+* **Module Source**: The stored text of a module, typically a WESL or WGSL file.
 * **Root Module**: The WESL module from which translation starts. A single project can have many root modules.
-* **Module Path**: Hierarchical address of a module file or partial path, akin to a filesystem path
+* **Declaration Path**: A fully qualified `::`-separated path whose final segment names a declared item.
+* **Module Path**: A `::`-separated path naming a module; equivalently, a declaration path minus its final segment. See [Imports](Imports.md#resolving-a-declaration-path).
+* **Import Path**: The `::`-separated path written in an import statement. An import collection (`{}`) flattens into separate imports, each with its own import path.
+* **Package Module**: The top-level module of a package, stored as the optional file `package.wesl` in the package root. A module path consisting only of `package` or a bare package name refers to the package module.
 * **Side effects**: WESL/WGSL shader code that is visible to host code (e.g. in Rust or JavaScript).
   Changes to that shader code have the side effect of changing the host interface to the shader.
   * Things that are specified when [creating a WGSL pipeline](https://developer.mozilla.org/en-US/docs/Web/API/GPUDevice/createRenderPipeline#fragment_object_structure)

NameMangling.md

@@ -14,7 +14,7 @@ See also renaming host visible names in [Visibility](./Visibility.md).
 ## What gets mangled
 All declaration identifiers get mangled, except:
 
-* root module declarations (this is being discussed, see <https://github.com/wgsl-tooling-wg/wesl-js/issues/98>)
+* root module declarations (this is being discussed, see <https://github.com/webgpu-tools/wesl-js/issues/98>)
 * declarations imported in the root module
   * if the import renames the declaration (using the `import foo as bar` syntax), the declaration is renamed.
   * if the import is a module (`import some::module` where `some/module.wesl` exists) it does not affect mangling.

README.md

@@ -26,7 +26,7 @@ their own enhancements and associated tools.
 And a shared standard can enable reusable WGSL libraries
 on npm and crates.io.
 
-Join us on [GitHub](https://github.com/wgsl-tooling-wg/wesl-spec)
+Join us on [GitHub](https://github.com/webgpu-tools/wesl-spec)
 or [Discord](https://discord.gg/Ng5FWmHuSv) to help.
 
 ## Goals