Merge remote-tracking branch 'origin/main' into feat/flavor-snippets

Author: NathanWalker

content/plugins/firebase-core.md

@@ -15,23 +15,23 @@ A plugin to initialize [FirebaseApp](https://firebase.google.com/docs/reference/
 
 Use this plugin with any of the following plugins:
 
-- [@nativescript/firebase-admob](../firebase-admob/)
-- [@nativescript/firebase-analytics](../firebase-admob/)
-- [@nativescript/firebase-app-check](../firebase-app-check/)
-- [@nativescript/firebase-app-check-debug](../firebase-app-check-debug/)
-- [@nativescript/firebase-auth](../firebase-auth/)
-- [@nativescript/firebase-crashlytics](../firebase-analytics/)
-- [@nativescript/firebase-database](../firebase-database/)
-- [@nativescript/firebase-dynamic-links](../firebase-dynamic-links/)
-- [@nativescript/firebase-firestore](../firebase-firestore/)
-- [@nativescript/firebase-functions](../firebase-functions/)
-- [@nativescript/firebase-in-app-messaging](../firebase-in-app-messaging/)
-- [@nativescript/firebase-installations](../firebase-installations/)
-- [@nativescript/firebase-messaging](../firebase-messaging/)
-- [@nativescript/firebase-messaging-core](../firebase-messaging-core/)
-- [@nativescript/firebase-performance](../firebase-performance/)
-- [@nativescript/firebase-remote-config](../firebase-remote-config/)
-- [@nativescript/firebase-storage](../firebase-storage/)
+- [@nativescript/firebase-admob](https://docs.nativescript.org/plugins/firebase-admob)
+- [@nativescript/firebase-analytics](https://docs.nativescript.org/plugins/firebase-analytics)
+- [@nativescript/firebase-app-check](https://docs.nativescript.org/plugins/firebase-app-check)
+- [@nativescript/firebase-app-check-debug](https://docs.nativescript.org/plugins/firebase-app-check-debug)
+- [@nativescript/firebase-auth](https://docs.nativescript.org/plugins/firebase-auth)
+- [@nativescript/firebase-crashlytics](https://docs.nativescript.org/plugins/firebase-crashlytics)
+- [@nativescript/firebase-database](https://docs.nativescript.org/plugins/firebase-database)
+- [@nativescript/firebase-dynamic-links](https://docs.nativescript.org/plugins/firebase-dynamic-links)
+- [@nativescript/firebase-firestore](https://docs.nativescript.org/plugins/firebase-firestore)
+- [@nativescript/firebase-functions](https://docs.nativescript.org/plugins/firebase-functions)
+- [@nativescript/firebase-in-app-messaging](https://docs.nativescript.org/plugins/firebase-in-app-messaging)
+- [@nativescript/firebase-installations](https://docs.nativescript.org/plugins/firebase-installations)
+- [@nativescript/firebase-messaging](https://docs.nativescript.org/plugins/firebase-messaging)
+- [@nativescript/firebase-messaging-core](https://docs.nativescript.org/plugins/firebase-messaging-core)
+- [@nativescript/firebase-performance](https://docs.nativescript.org/plugins/firebase-performance)
+- [@nativescript/firebase-remote-config](https://docs.nativescript.org/plugins/firebase-remote-config)
+- [@nativescript/firebase-storage](https://docs.nativescript.org/plugins/firebase-storage)
 
 ## Installation
 

content/plugins/firebase-database.md

@@ -169,15 +169,14 @@ If you are listening to a node with many children, only listening to data you ca
 ```ts
 import { firebase } from '@nativescript/firebase-core'
 
-const onChildAdd = firebase()
-  .database()
-  .ref('/users')
-  .on('child_added', (snapshot) => {
-    console.log('A new node has been added', snapshot.val())
-  })
+const ref = firebase().database().ref('/users')
+
+const onChildAdd = ref.on('child_added', (snapshot) => {
+  console.log('A new node has been added', snapshot.val())
+})
 
 // Stop listening for updates when no longer required
-firebase().database().ref('/users').off('child_added', onChildAdd)
+ref.off('child_added', onChildAdd)
 ```
 
 ### Remove a reference event listener
@@ -187,17 +186,22 @@ To unsubscribe from an event, call the `off` method on the reference passing it
 ```ts
 import { firebase } from '@nativescript/firebase-core'
 
-const onValueChange = firebase()
-  .database()
-  .ref(`/users/${userId}`)
-  .on('value', (snapshot) => {
-    console.log('User data: ', snapshot.val())
-  })
+const ref = firebase().database().ref(`/users/${userId}`)
+
+const onValueChange = ref.on('value', (snapshot) => {
+  console.log('User data: ', snapshot.val())
+})
 
 // Stop listening for updates when no longer required
-firebase().database().ref(`/users/${userId}`).off('value', onValueChange)
+ref.off('value', onValueChange)
 ```
 
+:::tip Note
+
+The `off` method requires the same `ref` as specified on the corresponding `on` method. The event handler specified in the `on` method must be unique. If a common event handler is used for multiple events, an anonymous function can be used to invoke the common handler.
+
+:::
+
 ### Data querying
 
 Realtime Database provides support for basic querying of your data. When a reference node contains children, you can both order & limit the returned results.

content/project-structure/app-resources.md

@@ -7,7 +7,7 @@ contributors:
 
 The App_Resources folder contains platform-specific resources of the application (icons, configuration files, native code, etc.). An application that supports both Android and iOS would therefore contain a subfolder for each platform.
 
-This page serves as a quick reference to understand how most settings in App_Resources affect behavior and the the look of a NativeScript app.
+This page serves as a quick reference to understand how most settings in App_Resources affect the behavior and the look of a NativeScript app.
 
 ## Android specific resources
 
@@ -27,7 +27,7 @@ App_Resources/
 └─ ... more
 ```
 
-Values can be overriden on specific API levels by making the changes in the corresponding directories.
+Values can be overridden on specific API levels by making the changes in the corresponding directories.
 
 ### Android app display name
 
@@ -62,7 +62,7 @@ To change the default color of the status bar, edit the `ns_primaryDark` color i
 
 :::tip Note
 
-The color will be applied on API21+ since lower API leves do not support custom status bar colors\*.
+The color will be applied on API21+ since lower API levels do not support custom status bar colors\*.
 
 :::
 
@@ -79,7 +79,7 @@ Various native elements have an accent color, which can be changed by setting th
 
 :::tip Note
 
-The color will be applied on API21+ since lower API leves do not support custom accent colors.
+The color will be applied on API21+ since lower API levels do not support custom accent colors.
 
 :::
 

content/project-structure/src/fonts.md

@@ -25,12 +25,12 @@ Add a new css class (for example in [`app.css`](/project-structure/src/app-css-s
 
 ```css
 .font-albert-sans {
-  font-family: "Albert Sans", "albert-sans-700";
+  font-family: 'Albert Sans', 'albert-sans-700';
   font-weight: 700;
 }
 
 .far {
-  font-family: "Font Awesome 5 Free", "fa-regular-400";
+  font-family: 'Font Awesome 5 Free', 'fa-regular-400';
   font-weight: 400;
 }
 ```
@@ -66,7 +66,7 @@ In Vue, when using html entities like the char codes above, use the `.decode` mo
 
 ::: details Sizing font images
 Images have specific stretch options (`none`, `aspectFit`, `aspectFill`). Font icons on the other hand usually use `font-size` to control the size of the icon.
-When using an `Image`, you can control the size with `font-size`, but you need to set `stretch="none"` for it to take effect. Setting `stretch` to anything other than `none` will cause the icon to be streched by measuring the image.
+When using an `Image`, you can control the size with `font-size`, but you need to set `stretch="none"` for it to take effect. Setting `stretch` to anything other than `none` will cause the icon to be stretched by measuring the image.
 :::
 
 If an icon doesn't appear, or renders unintended characters, make sure you are using the correct font family and weight.

content/setup/windows.md

@@ -128,7 +128,7 @@ ns doctor android
 
 If you see **No issues were detected** then you have successfully set up your system.
 
-Lastly, you will also want to [set up an android device or emulator](#setting-up-an-android-device-or-emulator).
+Lastly, you will also want to [set up an android device](/guide/running#enable-usb-debugging-on-android-devices) or [emulator](/guide/running#android-emulators).
 
 ::: warning Troubleshooting
 

content/snacks/index.md

@@ -293,6 +293,20 @@ Each Snack reveals NativeScript's power, from UI tricks to platform SDK usages t
     videoUrl: "https://youtube.com/embed/bXSyBTGJIlc",
     videoTitle: "Top Bar Height with NativeScript",
   },
+  {
+    id: 19,
+    title: "iOS Spotlight Search",
+    href: "https://stackblitz.com/edit/nativescript-ios-spotlight-search?file=src%2Fapp%2Fitem%2Fitem.service.ts",
+    description: "How to allow app content to be searchable using iOS Core Spotlight.",
+    categories: [
+      {
+        title: "iOS Core Spotlight",
+        href: "https://developer.apple.com/documentation/corespotlight",
+      },
+    ],
+    videoUrl: "https://youtube.com/embed/uzzMskFL5g8",
+    videoTitle: "Use iOS Spotlight Search with NativeScript",
+  },
   // Not ready yet but will discuss with Dylan to update
   // {
   //   id: 15,

content/ui/segmented-bar.md

@@ -47,6 +47,18 @@ To set the background color of the entire bar, use `backgroundColor`.
 
 See [Color](/api/class/Color).
 
+### selectedTextColor
+
+```ts
+selectedTextColor: Color
+```
+
+Gets or sets the text color of the selected item.
+
+To set the text color of the entire bar, use `selectedTextColor`.
+
+See [Color](/api/class/Color).
+
 ### ...Inherited
 
 For additional inherited properties, refer to the [API Reference](/api/class/SegmentedBar).