Merge remote-tracking branch 'upstream/main' into fix-iter-ergonomics

.clang-format

@@ -0,0 +1,2 @@
+BasedOnStyle: LLVM
+AlwaysBreakTemplateDeclarations: Yes

.clang-tidy

@@ -0,0 +1,57 @@
+InheritParentConfig: true
+Checks: >
+        bugprone-argument-comment,
+        bugprone-assert-side-effect,
+        bugprone-branch-clone,
+        bugprone-copy-constructor-init,
+        bugprone-dangling-handle,
+        bugprone-dynamic-static-initializers,
+        bugprone-macro-parentheses,
+        bugprone-macro-repeated-side-effects,
+        bugprone-misplaced-widening-cast,
+        bugprone-move-forwarding-reference,
+        bugprone-multiple-statement-macro,
+        bugprone-suspicious-semicolon,
+        bugprone-swapped-arguments,
+        bugprone-terminating-continue,
+        bugprone-unused-raii,
+        bugprone-unused-return-value,
+        misc-redundant-expression,
+        misc-static-assert,
+        misc-unused-using-decls,
+        modernize-use-bool-literals,
+        modernize-loop-convert,
+        modernize-make-unique,
+        modernize-raw-string-literal,
+        modernize-use-equals-default,
+        modernize-use-default-member-init,
+        modernize-use-emplace,
+        modernize-use-nullptr,
+        modernize-use-override,
+        modernize-use-using,
+        performance-for-range-copy,
+        performance-implicit-conversion-in-loop,
+        performance-inefficient-algorithm,
+        performance-inefficient-vector-operation,
+        performance-move-const-arg,
+        performance-no-automatic-move,
+        performance-trivially-destructible,
+        performance-unnecessary-copy-initialization,
+        performance-unnecessary-value-param,
+        readability-avoid-const-params-in-decls,
+        readability-const-return-type,
+        readability-container-size-empty,
+        readability-inconsistent-declaration-parameter-name,
+        readability-misleading-indentation,
+        readability-redundant-control-flow,
+        readability-redundant-smartptr-get,
+        readability-simplify-subscript-expr,
+        readability-use-anyofallof
+
+CheckOptions:
+  - key:             readability-identifier-naming.MemberCase
+    value:           camelBack
+  - key:             readability-identifier-naming.ParameterCase
+    value:           camelBack
+  - key:             readability-identifier-naming.VariableCase
+    value:           camelBack

.gitattributes

@@ -0,0 +1,4 @@
+# Add an override so that .🔥 files are highlighted as Mojo files within github
+# since the linguist system does not work with the .🔥 extention.
+# See https://github.com/github/linguist/blob/master/docs/overrides.md
+*.🔥 linguist-language=Mojo

.github/CODEOWNERS

@@ -1,14 +1,18 @@
-# Code owners for the Mojo repository
+# Codeowners for MAX repo.
+# Every line is a file pattern that is followed by one or more code owners.
+# Order is important; the last matching pattern takes the most precedence.
 
 # Standard Library Sources
-/stdlib/       @modularml/mojo-standard-library
+/mojo/stdlib/       @modular/stdlib
 
 # Documentation
-/docs/         @modularml/mojo-docs
+/mojo/docs/         @modular/mojo-docs
 
-/docs/changelog.md @modularml/mojo-standard-library
+/mojo/docs/changelog.md @modular/stdlib
 
-/stdlib/docs/  @modularml/mojo-docs @modularml/mojo-standard-library
+/mojo/stdlib/docs/  @modular/mojo-docs @modular/stdlib
 
 # Examples
-/examples/     @jackos
+/examples/mojo/     @jackos
+
+* @modularml/max-code-reviewers

.github/ISSUE_TEMPLATE/doc_issue.yaml

@@ -1,17 +1,31 @@
+##===----------------------------------------------------------------------===##
+# Copyright (c) 2025, Modular Inc. All rights reserved.
+#
+# Licensed under the Apache License v2.0 with LLVM Exceptions:
+# https://llvm.org/LICENSE.txt
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+##===----------------------------------------------------------------------===##
+
 name: Documentation issue
-description: Report a problem with the Mojo docs
+description: Report a problem with the MAX docs
 title: "[Docs]"
 labels:
   - documentation
 body:
   - type: markdown
     attributes:
       value: |
-        Thank you for helping us improve the Mojo docs!
+        Thank you for helping us improve the MAX docs!
 
         Please add a title above and fill in the following fields so we can understand the problem.
 
   - type: input
+    id: url
     attributes:
       label: Where is the problem?
       description: Provide a link to the problematic page (with a heading anchor).

.github/ISSUE_TEMPLATE/magic_issue.yaml

@@ -0,0 +1,61 @@
+##===----------------------------------------------------------------------===##
+# Copyright (c) 2025, Modular Inc. All rights reserved.
+#
+# Licensed under the Apache License v2.0 with LLVM Exceptions:
+# https://llvm.org/LICENSE.txt
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+##===----------------------------------------------------------------------===##
+
+name: Magic issue report
+description: Create an issue to help us improve Magic
+title: "[Magic]"
+labels:
+  - "magic"
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out a bug report!
+
+        Please provide a descriptive title above and fill in the following fields.
+
+  - type: textarea
+    id: Description
+    attributes:
+      label: Bug description
+      description: Describe the bug you encountered and what you expected to happen.
+      value: |
+        ### Actual behavior
+        <!-- Add a clear and concise description of what actually happened. -->
+
+        ### Expected behavior
+        <!-- Add a clear and concise description of what you expected to happen. -->
+    validations:
+      required: true
+
+  - type: textarea
+    id: Steps
+    attributes:
+      label: Steps to reproduce
+      description: Provide the specific steps to reproduce the issue.
+      value: |
+        - Provide a relevant code snippet or a link to the code that did not work as expected.
+        - If applicable, add screenshots to help explain the problem.
+        - If using the Playground, name the pre-existing notebook that failed and the steps that led to failure.
+        - Include anything else that might help us debug the issue.
+    validations:
+      required: true
+
+  - type: textarea
+    id: Context
+    attributes:
+      label: System information
+      description: What version of Mojo are you using?
+      value: |
+        - Provide the system information by running `magic info`.
+        - Provide version information for MAX (includes Mojo) by pasting the output of `magic list max`.

.github/ISSUE_TEMPLATE/max_bug_report.yaml

@@ -0,0 +1,55 @@
+##===----------------------------------------------------------------------===##
+# Copyright (c) 2025, Modular Inc. All rights reserved.
+#
+# Licensed under the Apache License v2.0 with LLVM Exceptions:
+# https://llvm.org/LICENSE.txt
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+##===----------------------------------------------------------------------===##
+
+name: MAX bug report
+description: Create a bug report to help us improve MAX
+title: "[BUG]: "
+labels:
+  - "bug,max"
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out a bug report!
+
+        Please provide a descriptive title above and fill in the following fields.
+
+  - type: textarea
+    id: Description
+    attributes:
+      label: Bug description
+      description: Describe the bug you encountered and what you expected to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    id: Steps
+    attributes:
+      label: Steps to reproduce
+      description: Provide the specific steps to reproduce the issue.
+      value: |
+        - Include relevant code snippet or link to code that did not work as expected.
+        - If applicable, add screenshots to help explain the problem.
+        - Include anything else that might help us debug the issue.
+    validations:
+      required: true
+
+  - type: textarea
+    id: Context
+    attributes:
+      label: System information
+      description: What version of MAX are you using?
+      value: |
+        - Provide the system information by running `magic info`.
+        - Provide version information for MAX (includes Mojo) by pasting the output of `magic list max`.
+      render: shell

.github/ISSUE_TEMPLATE/max_builds_bug_report.yaml

@@ -0,0 +1,53 @@
+##===----------------------------------------------------------------------===##
+# Copyright (c) 2025, Modular Inc. All rights reserved.
+#
+# Licensed under the Apache License v2.0 with LLVM Exceptions:
+# https://llvm.org/LICENSE.txt
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+##===----------------------------------------------------------------------===##
+
+name: MAX Builds model bug report
+description: Report a bug with a model
+title: "[BUG]: "
+labels:
+  - max-builds
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out a bug report!
+
+        Please provide a descriptive title above and fill in the following fields.
+
+  - type: input
+    id: model-variant
+    attributes:
+      label: On which model did the bug occur?
+      description: Provide the model (and variant).
+    validations:
+      required: true
+
+  - type: textarea
+    id: Description
+    attributes:
+      label: Bug description
+      description: Describe the bug you encountered and what you expected to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    id: Steps
+    attributes:
+      label: Steps to reproduce
+      description: Provide the specific steps to reproduce the issue.
+      value: |
+        - Include relevant code snippet or link to code that did not work as expected.
+        - If applicable, add screenshots to help explain the problem.
+        - Include anything else that might help us debug the issue.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/max_feature_request.yaml

@@ -0,0 +1,49 @@
+##===----------------------------------------------------------------------===##
+# Copyright (c) 2025, Modular Inc. All rights reserved.
+#
+# Licensed under the Apache License v2.0 with LLVM Exceptions:
+# https://llvm.org/LICENSE.txt
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+##===----------------------------------------------------------------------===##
+
+name: MAX feature request
+description: Suggest an enhancement for MAX
+title: "[Feature Request]"
+labels:
+  - "enhancement,max"
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to suggest a MAX enhancement!
+
+        Please enter a concise title above and fill out the following fields.
+
+  - type: textarea
+    id: Request
+    attributes:
+      label: What is your request?
+      description: Describe how you'd like us to improve MAX.
+    validations:
+      required: true
+
+  - type: textarea
+    id: Motivation
+    attributes:
+      label: What is your motivation for this change?
+      description: Describe the problem that your feature seeks to address (what is the value to the product/user?).
+    validations:
+      required: true
+
+  - type: textarea
+    id: Description
+    attributes:
+      label: Any other details?
+      description: Perhaps some minimum functional attributes the implementation should include, or other context about your feature.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/mojo_bug_report.yaml

@@ -1,3 +1,16 @@
+##===----------------------------------------------------------------------===##
+# Copyright (c) 2025, Modular Inc. All rights reserved.
+#
+# Licensed under the Apache License v2.0 with LLVM Exceptions:
+# https://llvm.org/LICENSE.txt
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+##===----------------------------------------------------------------------===##
+
 name: Mojo bug report
 description: Create a bug report to help us improve Mojo
 title: "[BUG]"

.github/ISSUE_TEMPLATE/mojo_feature_request.yaml

@@ -1,3 +1,16 @@
+##===----------------------------------------------------------------------===##
+# Copyright (c) 2025, Modular Inc. All rights reserved.
+#
+# Licensed under the Apache License v2.0 with LLVM Exceptions:
+# https://llvm.org/LICENSE.txt
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+##===----------------------------------------------------------------------===##
+
 name: Mojo feature request
 description: Suggest an enhancement for Mojo
 title: "[Feature Request]"
@@ -23,7 +36,7 @@ body:
   - type: markdown
     attributes:
       value: |
-        If the request is out of the published roadmap and priorities, please start an [idea](https://github.com/modularml/mojo/discussions/categories/ideas) in GH Discussions to get feedback from the team.
+        If the request is out of the published roadmap and priorities, please start a [discussion](https://forum.modular.com/) in the Modular Forum to get feedback from the team.
 
   - type: textarea
     id: Request