Scope deprecations (#5798)

crates/typst-eval/src/call.rs

@@ -315,13 +315,15 @@ fn eval_field_call(
         (target, args)
     };
 
+    let field_span = field.span();
+    let sink = (&mut vm.engine, field_span);
     if let Some(callee) = target.ty().scope().get(&field) {
         args.insert(0, target_expr.span(), target);
-        Ok(FieldCall::Normal(callee.read().clone(), args))
+        Ok(FieldCall::Normal(callee.read_checked(sink).clone(), args))
     } else if let Value::Content(content) = &target {
         if let Some(callee) = content.elem().scope().get(&field) {
             args.insert(0, target_expr.span(), target);
-            Ok(FieldCall::Normal(callee.read().clone(), args))
+            Ok(FieldCall::Normal(callee.read_checked(sink).clone(), args))
         } else {
             bail!(missing_field_call_error(target, field))
         }
@@ -331,7 +333,7 @@ fn eval_field_call(
     ) {
         // Certain value types may have their own ways to access method fields.
         // e.g. `$arrow.r(v)$`, `table.cell[..]`
-        let value = target.field(&field).at(field.span())?;
+        let value = target.field(&field, sink).at(field_span)?;
         Ok(FieldCall::Normal(value, args))
     } else {
         // Otherwise we cannot call this field.
@@ -364,7 +366,7 @@ fn missing_field_call_error(target: Value, field: Ident) -> SourceDiagnostic {
                 field.as_str(),
             ));
         }
-        _ if target.field(&field).is_ok() => {
+        _ if target.field(&field, ()).is_ok() => {
             error.hint(eco_format!(
                 "did you mean to access the field `{}`?",
                 field.as_str(),

crates/typst-eval/src/code.rs

@@ -154,7 +154,13 @@ impl Eval for ast::Ident<'_> {
     type Output = Value;
 
     fn eval(self, vm: &mut Vm) -> SourceResult<Self::Output> {
-        Ok(vm.scopes.get(&self).at(self.span())?.read().clone())
+        let span = self.span();
+        Ok(vm
+            .scopes
+            .get(&self)
+            .at(span)?
+            .read_checked((&mut vm.engine, span))
+            .clone())
     }
 }
 
@@ -310,8 +316,9 @@ impl Eval for ast::FieldAccess<'_> {
     fn eval(self, vm: &mut Vm) -> SourceResult<Self::Output> {
         let value = self.target().eval(vm)?;
         let field = self.field();
+        let field_span = field.span();
 
-        let err = match value.field(&field).at(field.span()) {
+        let err = match value.field(&field, (&mut vm.engine, field_span)).at(field_span) {
             Ok(value) => return Ok(value),
             Err(err) => err,
         };

crates/typst-eval/src/math.rs

@@ -35,7 +35,13 @@ impl Eval for ast::MathIdent<'_> {
     type Output = Value;
 
     fn eval(self, vm: &mut Vm) -> SourceResult<Self::Output> {
-        Ok(vm.scopes.get_in_math(&self).at(self.span())?.read().clone())
+        let span = self.span();
+        Ok(vm
+            .scopes
+            .get_in_math(&self)
+            .at(span)?
+            .read_checked((&mut vm.engine, span))
+            .clone())
     }
 }
 

crates/typst-ide/src/complete.rs

@@ -414,7 +414,7 @@ fn field_access_completions(
         // with method syntax;
         // 2. We can unwrap the field's value since it's a field belonging to
         // this value's type, so accessing it should not fail.
-        ctx.value_completion(field, &value.field(field).unwrap());
+        ctx.value_completion(field, &value.field(field, ()).unwrap());
     }
 
     match value {

crates/typst-library/src/diag.rs

@@ -11,6 +11,7 @@ use ecow::{eco_vec, EcoVec};
 use typst_syntax::package::{PackageSpec, PackageVersion};
 use typst_syntax::{Span, Spanned, SyntaxError};
 
+use crate::engine::Engine;
 use crate::{World, WorldExt};
 
 /// Early-return with a [`StrResult`] or [`SourceResult`].
@@ -228,6 +229,23 @@ impl From<SyntaxError> for SourceDiagnostic {
     }
 }
 
+/// Destination for a deprecation message when accessing a deprecated value.
+pub trait DeprecationSink {
+    /// Emits the given deprecation message into this sink.
+    fn emit(self, message: &str);
+}
+
+impl DeprecationSink for () {
+    fn emit(self, _: &str) {}
+}
+
+impl DeprecationSink for (&mut Engine<'_>, Span) {
+    /// Emits the deprecation message as a warning.
+    fn emit(self, message: &str) {
+        self.0.sink.warn(SourceDiagnostic::warning(self.1, message));
+    }
+}
+
 /// A part of a diagnostic's [trace](SourceDiagnostic::trace).
 #[derive(Debug, Clone, Eq, PartialEq, Ord, PartialOrd, Hash)]
 pub enum Tracepoint {

crates/typst-library/src/foundations/func.rs

@@ -9,7 +9,7 @@ use ecow::{eco_format, EcoString};
 use typst_syntax::{ast, Span, SyntaxNode};
 use typst_utils::{singleton, LazyHash, Static};
 
-use crate::diag::{bail, At, SourceResult, StrResult};
+use crate::diag::{bail, At, DeprecationSink, SourceResult, StrResult};
 use crate::engine::Engine;
 use crate::foundations::{
     cast, repr, scope, ty, Args, Bytes, CastInfo, Content, Context, Element, IntoArgs,
@@ -255,11 +255,15 @@ impl Func {
     }
 
     /// Get a field from this function's scope, if possible.
-    pub fn field(&self, field: &str) -> StrResult<&'static Value> {
+    pub fn field(
+        &self,
+        field: &str,
+        sink: impl DeprecationSink,
+    ) -> StrResult<&'static Value> {
         let scope =
             self.scope().ok_or("cannot access fields on user-defined functions")?;
         match scope.get(field) {
-            Some(binding) => Ok(binding.read()),
+            Some(binding) => Ok(binding.read_checked(sink)),
             None => match self.name() {
                 Some(name) => bail!("function `{name}` does not contain field `{field}`"),
                 None => bail!("function does not contain field `{field}`"),

crates/typst-library/src/foundations/module.rs

@@ -4,7 +4,7 @@ use std::sync::Arc;
 use ecow::{eco_format, EcoString};
 use typst_syntax::FileId;
 
-use crate::diag::{bail, StrResult};
+use crate::diag::{bail, DeprecationSink, StrResult};
 use crate::foundations::{repr, ty, Content, Scope, Value};
 
 /// An module of definitions.
@@ -118,9 +118,9 @@ impl Module {
     }
 
     /// Try to access a definition in the module.
-    pub fn field(&self, field: &str) -> StrResult<&Value> {
+    pub fn field(&self, field: &str, sink: impl DeprecationSink) -> StrResult<&Value> {
         match self.scope().get(field) {
-            Some(binding) => Ok(binding.read()),
+            Some(binding) => Ok(binding.read_checked(sink)),
             None => match &self.name {
                 Some(name) => bail!("module `{name}` does not contain `{field}`"),
                 None => bail!("module does not contain `{field}`"),

crates/typst-library/src/foundations/scope.rs

@@ -10,7 +10,7 @@ use indexmap::IndexMap;
 use typst_syntax::Span;
 use typst_utils::Static;
 
-use crate::diag::{bail, HintedStrResult, HintedString, StrResult};
+use crate::diag::{bail, DeprecationSink, HintedStrResult, HintedString, StrResult};
 use crate::foundations::{
     Element, Func, IntoValue, NativeElement, NativeFunc, NativeFuncData, NativeType,
     Type, Value,
@@ -258,6 +258,8 @@ pub struct Binding {
     span: Span,
     /// The category of the binding.
     category: Option<Category>,
+    /// A deprecation message for the definition.
+    deprecation: Option<&'static str>,
 }
 
 /// The different kinds of slots.
@@ -277,6 +279,7 @@ impl Binding {
             span,
             kind: BindingKind::Normal,
             category: None,
+            deprecation: None,
         }
     }
 
@@ -285,11 +288,29 @@ impl Binding {
         Self::new(value, Span::detached())
     }
 
+    /// Marks this binding as deprecated, with the given `message`.
+    pub fn deprecated(&mut self, message: &'static str) -> &mut Self {
+        self.deprecation = Some(message);
+        self
+    }
+
     /// Read the value.
     pub fn read(&self) -> &Value {
         &self.value
     }
 
+    /// Read the value, checking for deprecation.
+    ///
+    /// As the `sink`
+    /// - pass `()` to ignore the message.
+    /// - pass `(&mut engine, span)` to emit a warning into the engine.
+    pub fn read_checked(&self, sink: impl DeprecationSink) -> &Value {
+        if let Some(message) = self.deprecation {
+            sink.emit(message);
+        }
+        &self.value
+    }
+
     /// Try to write to the value.
     ///
     /// This fails if the value is a read-only closure capture.
@@ -320,6 +341,11 @@ impl Binding {
         self.span
     }
 
+    /// A deprecation message for the value, if any.
+    pub fn deprecation(&self) -> Option<&'static str> {
+        self.deprecation
+    }
+
     /// The category of the value, if any.
     pub fn category(&self) -> Option<Category> {
         self.category

crates/typst-library/src/foundations/ty.rs

@@ -8,7 +8,7 @@ use std::sync::LazyLock;
 use ecow::{eco_format, EcoString};
 use typst_utils::Static;
 
-use crate::diag::{bail, StrResult};
+use crate::diag::{bail, DeprecationSink, StrResult};
 use crate::foundations::{
     cast, func, AutoValue, Func, NativeFuncData, NoneValue, Repr, Scope, Value,
 };
@@ -94,9 +94,13 @@ impl Type {
     }
 
     /// Get a field from this type's scope, if possible.
-    pub fn field(&self, field: &str) -> StrResult<&'static Value> {
+    pub fn field(
+        &self,
+        field: &str,
+        sink: impl DeprecationSink,
+    ) -> StrResult<&'static Value> {
         match self.scope().get(field) {
-            Some(binding) => Ok(binding.read()),
+            Some(binding) => Ok(binding.read_checked(sink)),
             None => bail!("type {self} does not contain field `{field}`"),
         }
     }

crates/typst-library/src/foundations/value.rs

@@ -11,7 +11,7 @@ use serde::{Deserialize, Deserializer, Serialize, Serializer};
 use typst_syntax::{ast, Span};
 use typst_utils::ArcExt;
 
-use crate::diag::{HintedStrResult, HintedString, StrResult};
+use crate::diag::{DeprecationSink, HintedStrResult, HintedString, StrResult};
 use crate::foundations::{
     fields, ops, repr, Args, Array, AutoValue, Bytes, CastInfo, Content, Datetime,
     Decimal, Dict, Duration, Fold, FromValue, Func, IntoValue, Label, Module,
@@ -155,15 +155,15 @@ impl Value {
     }
 
     /// Try to access a field on the value.
-    pub fn field(&self, field: &str) -> StrResult<Value> {
+    pub fn field(&self, field: &str, sink: impl DeprecationSink) -> StrResult<Value> {
         match self {
             Self::Symbol(symbol) => symbol.clone().modified(field).map(Self::Symbol),
             Self::Version(version) => version.component(field).map(Self::Int),
             Self::Dict(dict) => dict.get(field).cloned(),
             Self::Content(content) => content.field_by_name(field),
-            Self::Type(ty) => ty.field(field).cloned(),
+            Self::Type(ty) => ty.field(field, sink).cloned(),
-            Self::Func(func) => func.field(field).cloned(),
+            Self::Func(func) => func.field(field, sink).cloned(),
-            Self::Module(module) => module.field(field).cloned(),
+            Self::Module(module) => module.field(field, sink).cloned(),
             _ => fields::field(self, field),
         }
     }

crates/typst-library/src/loading/cbor.rs

@@ -38,6 +38,7 @@ impl cbor {
     /// This function is deprecated. The [`cbor`] function now accepts bytes
     /// directly.
     #[func(title = "Decode CBOR")]
+    #[deprecated = "`cbor.decode` is deprecated, directly pass bytes to `cbor` instead"]
     pub fn decode(
         engine: &mut Engine,
         /// CBOR data.

crates/typst-library/src/loading/csv.rs

@@ -100,6 +100,7 @@ impl csv {
     /// This function is deprecated. The [`csv`] function now accepts bytes
     /// directly.
     #[func(title = "Decode CSV")]
+    #[deprecated = "`csv.decode` is deprecated, directly pass bytes to `csv` instead"]
     pub fn decode(
         engine: &mut Engine,
         /// CSV data.

crates/typst-library/src/loading/json.rs

@@ -69,6 +69,7 @@ impl json {
     /// This function is deprecated. The [`json`] function now accepts bytes
     /// directly.
     #[func(title = "Decode JSON")]
+    #[deprecated = "`json.decode` is deprecated, directly pass bytes to `json` instead"]
     pub fn decode(
         engine: &mut Engine,
         /// JSON data.

crates/typst-library/src/loading/toml.rs

@@ -48,6 +48,7 @@ impl toml {
     /// This function is deprecated. The [`toml`] function now accepts bytes
     /// directly.
     #[func(title = "Decode TOML")]
+    #[deprecated = "`toml.decode` is deprecated, directly pass bytes to `toml` instead"]
     pub fn decode(
         engine: &mut Engine,
         /// TOML data.

crates/typst-library/src/loading/xml.rs

@@ -81,6 +81,7 @@ impl xml {
     /// This function is deprecated. The [`xml`] function now accepts bytes
     /// directly.
     #[func(title = "Decode XML")]
+    #[deprecated = "`xml.decode` is deprecated, directly pass bytes to `xml` instead"]
     pub fn decode(
         engine: &mut Engine,
         /// XML data.

crates/typst-library/src/loading/yaml.rs

@@ -59,6 +59,7 @@ impl yaml {
     /// This function is deprecated. The [`yaml`] function now accepts bytes
     /// directly.
     #[func(title = "Decode YAML")]
+    #[deprecated = "`yaml.decode` is deprecated, directly pass bytes to `yaml` instead"]
     pub fn decode(
         engine: &mut Engine,
         /// YAML data.

crates/typst-library/src/visualize/image/mod.rs

@@ -171,6 +171,7 @@ impl ImageElem {
     /// #image.decode(changed)
     /// ```
     #[func(title = "Decode Image")]
+    #[deprecated = "`image.decode` is deprecated, directly pass bytes to `image` instead"]
     pub fn decode(
         span: Span,
         /// The data to decode as an image. Can be a string for SVGs.

crates/typst-library/src/visualize/mod.rs

@@ -24,7 +24,7 @@ pub use self::shape::*;
 pub use self::stroke::*;
 pub use self::tiling::*;
 
-use crate::foundations::{category, Category, Scope, Type};
+use crate::foundations::{category, Category, Element, Scope, Type};
 
 /// Drawing and data visualization.
 ///
@@ -49,8 +49,10 @@ pub(super) fn define(global: &mut Scope) {
     global.define_elem::<CircleElem>();
     global.define_elem::<PolygonElem>();
     global.define_elem::<CurveElem>();
-    global.define_elem::<PathElem>();
+    global
-
+        .define("path", Element::of::<PathElem>())
-    // Compatibility.
+        .deprecated("the `path` function is deprecated, use `curve` instead");
-    global.define("pattern", Type::of::<Tiling>());
+    global
+        .define("pattern", Type::of::<Tiling>())
+        .deprecated("the name `pattern` is deprecated, use `tiling` instead");
 }

crates/typst-library/src/visualize/path.rs

@@ -23,7 +23,7 @@ use crate::visualize::{FillRule, Paint, Stroke};
 /// ```
 ///
 /// # Deprecation
-/// This element is deprecated. The [`curve`] element should be used instead.
+/// This function is deprecated. The [`curve`] function should be used instead.
 #[elem(Show)]
 pub struct PathElem {
     /// How to fill the path.

crates/typst-macros/src/scope.rs

@@ -31,18 +31,37 @@ pub fn scope(_: TokenStream, item: syn::Item) -> Result<TokenStream> {
     let mut definitions = vec![];
     let mut constructor = quote! { None };
     for child in &mut item.items {
-        let def = match child {
+        let bare: BareType;
-            syn::ImplItem::Const(item) => handle_const(&self_ty_expr, item)?,
+        let (mut def, attrs) = match child {
-            syn::ImplItem::Fn(item) => match handle_fn(self_ty, item)? {
+            syn::ImplItem::Const(item) => {
-                FnKind::Member(tokens) => tokens,
+                (handle_const(&self_ty_expr, item)?, &item.attrs)
-                FnKind::Constructor(tokens) => {
+            }
-                    constructor = tokens;
+            syn::ImplItem::Fn(item) => (
-                    continue;
+                match handle_fn(self_ty, item)? {
-                }
+                    FnKind::Member(tokens) => tokens,
-            },
+                    FnKind::Constructor(tokens) => {
-            syn::ImplItem::Verbatim(item) => handle_type_or_elem(item)?,
+                        constructor = tokens;
+                        continue;
+                    }
+                },
+                &item.attrs,
+            ),
+            syn::ImplItem::Verbatim(item) => {
+                bare = syn::parse2(item.clone())?;
+                (handle_type_or_elem(&bare)?, &bare.attrs)
+            }
             _ => bail!(child, "unexpected item in scope"),
         };
+
+        if let Some(message) = attrs.iter().find_map(|attr| match &attr.meta {
+            syn::Meta::NameValue(pair) if pair.path.is_ident("deprecated") => {
+                Some(&pair.value)
+            }
+            _ => None,
+        }) {
+            def = quote! { #def.deprecated(#message) }
+        }
+
         definitions.push(def);
     }
 
@@ -61,6 +80,7 @@ pub fn scope(_: TokenStream, item: syn::Item) -> Result<TokenStream> {
                 #constructor
             }
 
+            #[allow(deprecated)]
             fn scope() -> #foundations::Scope {
                 let mut scope = #foundations::Scope::deduplicating();
                 #(#definitions;)*
@@ -78,8 +98,7 @@ fn handle_const(self_ty: &TokenStream, item: &syn::ImplItemConst) -> Result<Toke
 }
 
 /// Process a type item.
-fn handle_type_or_elem(item: &TokenStream) -> Result<TokenStream> {
+fn handle_type_or_elem(item: &BareType) -> Result<TokenStream> {
-    let item: BareType = syn::parse2(item.clone())?;
     let ident = &item.ident;
     let define = if item.attrs.iter().any(|attr| attr.path().is_ident("elem")) {
         quote! { define_elem }

docs/src/link.rs

@@ -69,7 +69,7 @@ fn resolve_definition(head: &str, base: &str) -> StrResult<String> {
     let Some(category) = category else { bail!("{head} has no category") };
 
     let name = parts.next().ok_or("link is missing first part")?;
-    let value = focus.field(name)?;
+    let value = focus.field(name, ())?;
 
     // Handle grouped functions.
     if let Some(group) = GROUPS.iter().find(|group| {
@@ -88,7 +88,7 @@ fn resolve_definition(head: &str, base: &str) -> StrResult<String> {
 
     let mut route = format!("{}reference/{}/{name}", base, category.name());
     if let Some(next) = parts.next() {
-        if let Ok(field) = value.field(next) {
+        if let Ok(field) = value.field(next, ()) {
             route.push_str("/#definitions-");
             route.push_str(next);
             if let Some(next) = parts.next() {

tests/suite/loading/cbor.typ

@@ -0,0 +1,3 @@
+--- cbor-decode-deprecated ---
+// Warning: 15-21 `cbor.decode` is deprecated, directly pass bytes to `cbor` instead
+#let _ = cbor.decode

tests/suite/loading/csv.typ

@@ -29,3 +29,7 @@
 --- csv-invalid-delimiter ---
 // Error: 41-51 delimiter must be an ASCII character
 #csv("/assets/data/zoo.csv", delimiter: "\u{2008}")
+
+--- csv-decode-deprecated ---
+// Warning: 14-20 `csv.decode` is deprecated, directly pass bytes to `csv` instead
+#let _ = csv.decode

tests/suite/loading/json.typ

@@ -9,6 +9,10 @@
 // Error: 7-30 failed to parse JSON (expected value at line 3 column 14)
 #json("/assets/data/bad.json")
 
+--- json-decode-deprecated ---
+// Warning: 15-21 `json.decode` is deprecated, directly pass bytes to `json` instead
+#let _ = json.decode
+
 --- issue-3363-json-large-number ---
 // Big numbers (larger than what i64 can store) should just lose some precision
 // but not overflow

tests/suite/loading/toml.typ

@@ -39,3 +39,7 @@
 --- toml-invalid ---
 // Error: 7-30 failed to parse TOML (expected `.`, `=` at line 1 column 16)
 #toml("/assets/data/bad.toml")
+
+--- toml-decode-deprecated ---
+// Warning: 15-21 `toml.decode` is deprecated, directly pass bytes to `toml` instead
+#let _ = toml.decode

tests/suite/loading/xml.typ

@@ -26,3 +26,7 @@
 --- xml-invalid ---
 // Error: 6-28 failed to parse XML (found closing tag 'data' instead of 'hello' in line 3)
 #xml("/assets/data/bad.xml")
+
+--- xml-decode-deprecated ---
+// Warning: 14-20 `xml.decode` is deprecated, directly pass bytes to `xml` instead
+#let _ = xml.decode

tests/suite/loading/yaml.typ

@@ -15,3 +15,7 @@
 --- yaml-invalid ---
 // Error: 7-30 failed to parse YAML (did not find expected ',' or ']' at line 2 column 1, while parsing a flow sequence at line 1 column 18)
 #yaml("/assets/data/bad.yaml")
+
+--- yaml-decode-deprecated ---
+// Warning: 15-21 `yaml.decode` is deprecated, directly pass bytes to `yaml` instead
+#let _ = yaml.decode

tests/suite/visualize/image.typ

@@ -161,22 +161,27 @@ A #box(image("/assets/images/tiger.jpg", height: 1cm, width: 80%)) B
 
 --- image-decode-svg ---
 // Test parsing from svg data
+// Warning: 8-14 `image.decode` is deprecated, directly pass bytes to `image` instead
 #image.decode(`<svg xmlns="http://www.w3.org/2000/svg" height="140" width="500"><ellipse cx="200" cy="80" rx="100" ry="50" style="fill:yellow;stroke:purple;stroke-width:2" /></svg>`.text, format: "svg")
 
 --- image-decode-bad-svg ---
 // Error: 2-168 failed to parse SVG (missing root node)
+// Warning: 8-14 `image.decode` is deprecated, directly pass bytes to `image` instead
 #image.decode(`<svg height="140" width="500"><ellipse cx="200" cy="80" rx="100" ry="50" style="fill:yellow;stroke:purple;stroke-width:2" /></svg>`.text, format: "svg")
 
 --- image-decode-detect-format ---
 // Test format auto detect
+// Warning: 8-14 `image.decode` is deprecated, directly pass bytes to `image` instead
 #image.decode(read("/assets/images/tiger.jpg", encoding: none), width: 80%)
 
 --- image-decode-specify-format ---
 // Test format manual
+// Warning: 8-14 `image.decode` is deprecated, directly pass bytes to `image` instead
 #image.decode(read("/assets/images/tiger.jpg", encoding: none), format: "jpg", width: 80%)
 
 --- image-decode-specify-wrong-format ---
 // Error: 2-91 failed to decode image (Format error decoding Png: Invalid PNG signature.)
+// Warning: 8-14 `image.decode` is deprecated, directly pass bytes to `image` instead
 #image.decode(read("/assets/images/tiger.jpg", encoding: none), format: "png", width: 80%)
 
 --- image-pixmap-empty ---

tests/suite/visualize/path.typ

@@ -6,6 +6,7 @@
   columns: (1fr, 1fr),
   rows: (1fr, 1fr, 1fr),
   align: center + horizon,
+  // Warning: 3-7 the `path` function is deprecated, use `curve` instead
   path(
     fill: red,
     closed: true,
@@ -14,6 +15,7 @@
     ((0%, 50%), (4%, 4%)),
     ((50%, 0%), (4%, 4%)),
   ),
+  // Warning: 3-7 the `path` function is deprecated, use `curve` instead
   path(
     fill: purple,
     stroke: 1pt,
@@ -22,6 +24,7 @@
     (0pt, 30pt),
     (30pt, 0pt),
   ),
+  // Warning: 3-7 the `path` function is deprecated, use `curve` instead
   path(
     fill: blue,
     stroke: 1pt,
@@ -30,6 +33,7 @@
     ((30%, 60%), (-20%, 0%), (0%, 0%)),
     ((50%, 30%), (60%, -30%), (60%, 0%)),
   ),
+  // Warning: 3-7 the `path` function is deprecated, use `curve` instead
   path(
     stroke: 5pt,
     closed: true,
@@ -37,6 +41,7 @@
     (30pt, 30pt),
     (15pt, 0pt),
   ),
+  // Warning: 3-7 the `path` function is deprecated, use `curve` instead
   path(
     fill: red,
     fill-rule: "non-zero",
@@ -47,6 +52,7 @@
     (0pt, 20pt),
     (40pt, 50pt),
   ),
+  // Warning: 3-7 the `path` function is deprecated, use `curve` instead
   path(
     fill: red,
     fill-rule: "even-odd",
@@ -61,18 +67,22 @@
 
 --- path-bad-vertex ---
 // Error: 7-9 path vertex must have 1, 2, or 3 points
+// Warning: 2-6 the `path` function is deprecated, use `curve` instead
 #path(())
 
 --- path-bad-point-count ---
 // Error: 7-47 path vertex must have 1, 2, or 3 points
+// Warning: 2-6 the `path` function is deprecated, use `curve` instead
 #path(((0%, 0%), (0%, 0%), (0%, 0%), (0%, 0%)))
 
 --- path-bad-point-array ---
 // Error: 7-31 point array must contain exactly two entries
+// Warning: 2-6 the `path` function is deprecated, use `curve` instead
 #path(((0%, 0%), (0%, 0%, 0%)))
 
 --- path-infinite-length ---
 // Error: 2-42 cannot create path with infinite length
+// Warning: 2-6 the `path` function is deprecated, use `curve` instead
 #path((0pt, 0pt), (float.inf * 1pt, 0pt))
 
 --- issue-path-in-sized-container ---
@@ -82,6 +92,7 @@
   fill: aqua,
   width: 20pt,
   height: 15pt,
+  // Warning: 3-7 the `path` function is deprecated, use `curve` instead
   path(
     (0pt, 0pt),
     (10pt, 10pt),

tests/suite/visualize/tiling.typ

@@ -159,5 +159,7 @@
 
 --- tiling-pattern-compatibility ---
 #set page(width: auto, height: auto, margin: 0pt)
+
+// Warning: 10-17 the name `pattern` is deprecated, use `tiling` instead
 #let t = pattern(size: (10pt, 10pt), line(stroke: 4pt, start: (0%, 0%), end: (100%, 100%)))
 #rect(width: 50pt, height: 50pt, fill: t)