feat: 8.9 additions

.github/workflows/ci.yml

@@ -17,9 +17,9 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v3
         with:
-          node-version: 19
+          node-version: 22.14.0
           cache: 'npm'
-      - run: npm ci
+      - run: yarn
       - run: npm run lint --if-present
       - run: npm run build --if-present
         env:

.vitepress/clientAppEnhance.ts

@@ -0,0 +1,8 @@
+export default ({ router }) => {
+  router.afterEach(() => {
+    // Ensure the DOM is updated before scrolling
+    setTimeout(() => {
+      window.scrollTo(0, 0)
+    }, 0)
+  })
+}

.vitepress/config.mts

@@ -4,7 +4,8 @@ import mainSidebar from '../content/sidebar'
 import uiSidebar from '../content/ui/sidebar'
 import pluginsSidebar from '../content/plugins/sidebar'
 import nav from './nav'
-import './theme/cliLanguage'
+import './clientAppEnhance';
+// import './theme/cliLanguage'
 import path from 'node:path'
 import { SiteMap } from './genSitemap.mjs'
 
@@ -71,6 +72,7 @@ export default defineConfig({
   },
   markdown: {
     headers: true,
+    theme: "github-dark"
   },
   async transformPageData(pageData, { siteConfig }) {
     // const contributors = await githubAuthors.getAuthorsForFilePath(

.vitepress/theme/cliLanguage.ts

@@ -1,10 +1,10 @@
 // https://mysticmind.dev/vitepress-fenced-code-block-syntax-highlighting-quirks-with-net-or-other-languages
-import { BUNDLED_LANGUAGES } from "shiki";
-import cliLanguageGrammar from "./shiki/cli.tmLanguage.json";
+import { bundledLanguages } from 'shiki'
+import cliLanguageGrammar from './shiki/cli.tmLanguage.json'
 
-BUNDLED_LANGUAGES.push({
-  id: "cli",
-  scopeName: "source.cli",
-  // @ts-ignore
+bundledLanguages['cli'] = {
+  id: 'cli',
+  scopeName: 'source.cli',
   grammar: cliLanguageGrammar,
-});
+}
+// bundledLanguages.push()

content/best-practices/ios-tips.md

@@ -18,7 +18,7 @@ let applePayController: PKPaymentAuthorizationViewController
 
 applePayController =
   PKPaymentAuthorizationViewController.alloc().initWithPaymentRequest(
-    paymentRequest
+    paymentRequest,
   )
 applePayController.delegate =
   PKPaymentAuthorizationViewControllerDelegateImpl.initWithOwner(this)
@@ -32,7 +32,7 @@ let applePayControllerDelegate: PKPaymentAuthorizationViewControllerDelegateImpl
 
 applePayController =
   PKPaymentAuthorizationViewController.alloc().initWithPaymentRequest(
-    paymentRequest
+    paymentRequest,
   )
 applePayControllerDelegate =
   PKPaymentAuthorizationViewControllerDelegateImpl.initWithOwner(this)

content/best-practices/native-class.md

@@ -29,7 +29,7 @@ You can use setup methods in this case to mitigate any cross compilation issue,
 ```ts
 let customClass
 function setupCustomClass() {
-  if (global.isAndroid) {
+  if (__ANDROID__) {
     @NativeClass()
     class CustomClass extends android.view.View {}
     customClass = CustomClass
@@ -44,7 +44,7 @@ setupCustomClass()
 const customClassInstance = new customClass() // can handle different platform args with ternary if needed
 ```
 
-The `global.isAndroid` conditional will get removed when building the app for iOS so your compiled code is clean and isolated while allowing you to handle in a single file.
+The `__ANDROID__` macro will get removed when building the app for iOS so your compiled code is clean and isolated while allowing you to handle in a single file.
 
 ## When exported from a file and used elsewhere
 

content/best-practices/platform-file-split-or-not.md

@@ -28,7 +28,7 @@ The advent of tree shaking and webpack builds does away with quite a bit of worr
 
 ## Conditional with tree shaking
 
-When speaking of tree shaking ever since NativeScript 7, you've been able to use `global.isAndroid` or `global.isIOS` and anytime those are used as conditional splits in your code, only the applicable code for the platform that's being built would actually end up in your compiled code alleviating a lot of concern here.
+When speaking of tree shaking ever since NativeScript 7, you've been able to use `__ANDROID__` or `global.isIOS` and anytime those are used as conditional splits in your code, only the applicable code for the platform that's being built would actually end up in your compiled code alleviating a lot of concern here.
 
 ## Future maintenance
 

content/configuration/nativescript.md

@@ -371,6 +371,11 @@ ios.SPMPackages: Array<{
   libs: Array<string>;
   repositoryURL: string;
   version: string;
+  /**
+   * (8.9+) If you have more targets (like widgets for example),
+   * you can list their names here to include the Swift Package with them.
+   */
+  targets?: string[];
 }>
 ```
 
@@ -392,6 +397,63 @@ ios: {
 }
 ```
 
+### ios.NativeSource
+
+::: tip
+
+NativeSource config option is available in `[email protected]` or newer.
+
+:::
+
+```ts
+ios.NativeSource: Array<{
+  name: string;
+  path: string;
+}>
+```
+
+Include any native source code from anywhere in the project (or workspace). Glob patterns are fully supported.
+
+#### Example
+
+- Include any `.swift` files anywhere within the project `src` directory:
+
+```ts
+// ...
+ios: {
+  NativeSource: [
+    {
+      name: 'ProjectPlatformSrc',
+      path: './src/**/*.swift'
+    }
+  ],
+}
+```
+
+This will create a file reference folder named `ProjectPlatformSrc` within the generated Xcode project containing any .swift files found anywhere within the project `src` directory.
+
+- Include any `.swift` files anywhere within the project `src` directory, including any (Swift, Obj-C impl/headers, as well as any module.modulemap files) within a workspace `packages` or `libs` dir:
+
+```ts
+// ...
+ios: {
+  NativeSource: [
+    {
+      name: 'ProjectPlatformSrc',
+      path: './src/**/*.swift'
+    },
+    {
+      name: 'Auth',
+      path: '../../packages/**/*.{swift,m,h,modulemap}'
+    },
+    {
+      name: 'Purchasing',
+      path: '../../libs/**/*.{swift,m,h,modulemap}'
+    }
+  ],
+}
+```
+
 ## Hooks Configuration Reference
 
 ```ts

content/configuration/webpack.md

@@ -49,7 +49,7 @@ Add file replacement rules. For source files (`.js` and `.ts`) this will add a n
 
 Example:
 
-```cli
+```bash
 --env.replace=./src/environments/environment.ts:./src/environments/environment.prod.ts
 ```
 
@@ -324,7 +324,7 @@ module.exports = (env) => {
       config.get('externals').concat([
         // add your own externals
         'some-external-dependency',
-      ])
+      ]),
     )
   })
 
@@ -380,7 +380,7 @@ module.exports = (env) => {
 
 To change an existing rule, it's useful to know how it has been set up first:
 
-```cli
+```bash
 ns prepare android|ios --env.verbose
 # Note: we plan to add a separate command to just print the internal config
 ```
@@ -518,7 +518,7 @@ module.exports = (env) => {
       'ignoreWarnings',
       (config.get('ignoreWarnings') || []).concat([
         /a regex that matches the warning to suppress/,
-      ])
+      ]),
     )
   })
 
@@ -577,7 +577,7 @@ module.exports = (webpack) => {
         .test(/\.something$/)
         .use('something-loader')
         .loader('something-loader')
-    } /*, options */
+    } /*, options */,
   )
 }
 ```
@@ -641,7 +641,7 @@ webpack.chainWebpack(
   (config, env) => {
     config.set('somethingThatShouldBeSetLast', true)
   },
-  { order: 10 }
+  { order: 10 },
 )
 ```
 

content/core/application.md

@@ -47,7 +47,7 @@ if (isAndroid) {
   const androidApp: AndroidApplication = Application.android
 
   androidApp.unregisterBroadcastReceiver(
-    android.content.Intent.ACTION_BATTERY_CHANGED
+    android.content.Intent.ACTION_BATTERY_CHANGED,
   )
 }
 ```
@@ -76,7 +76,7 @@ To add an iOS notification observer, follow the steps below:
      UIDeviceOrientationDidChangeNotification,
      (notification: NSNotification) => {
        //Handle the notification
-     }
+     },
    )
    ```
 
@@ -89,7 +89,7 @@ To remove a notification observer, use the `removeNotificationObserver` method o
 ```ts
 iOSApp.removeNotificationObserver(
   observer,
-  UIDeviceBatteryStateDidChangeNotification
+  UIDeviceBatteryStateDidChangeNotification,
 )
 ```
 
@@ -350,7 +350,7 @@ const MyDelegate = (function (_super) {
   }
   MyDelegate.prototype.applicationDidFinishLaunchingWithOptions = function (
     application,
-    launchOptions
+    launchOptions,
   ) {
     console.log('applicationWillFinishLaunchingWithOptions: ' + launchOptions)
     return true
@@ -372,7 +372,7 @@ class MyDelegate extends UIResponder implements UIApplicationDelegate {
 
   applicationDidFinishLaunchingWithOptions(
     application: UIApplication,
-    launchOptions: NSDictionary<string, any>
+    launchOptions: NSDictionary<string, any>,
   ): boolean {
     console.log('applicationWillFinishLaunchingWithOptions: ' + launchOptions)
 

content/core/http.md

@@ -17,7 +17,7 @@ Http.getString('https://httpbin.org/get').then(
   (result: string) => {
     // do something with the string response
   },
-  (e) => {}
+  (e) => {},
 )
 ```
 
@@ -30,7 +30,7 @@ Http.getJSON('https://httpbin.org/get').then(
   (result) => {
     console.log(result)
   },
-  (e) => {}
+  (e) => {},
 )
 ```
 
@@ -40,12 +40,12 @@ Use the [getFile()](#getfile) method for a GET request with a response as a [Fil
 
 ```ts
 Http.getFile(
-  'https://art.nativescript.org/logo/export/NativeScript_Logo_Wide_White_Blue_Rounded_Blue.png'
+  'https://art.nativescript.org/logo/export/NativeScript_Logo_Wide_White_Blue_Rounded_Blue.png',
 ).then(
   (resultFile: File) => {
     // The returned result will be File object
   },
-  (e) => {}
+  (e) => {},
 )
 ```
 
@@ -56,7 +56,7 @@ Use the [getImage()](#getimage) method for a GET request with a response as an i
 ```ts
 Http.getImage('https://httpbin.org/image/jpeg').then(
   (res: ImageSource) => {},
-  (e) => {}
+  (e) => {},
 )
 ```
 
@@ -83,7 +83,7 @@ Http.request({
   },
   (e) => {
     // error
-  }
+  },
 )
 ```
 

content/core/image-source.md

@@ -58,7 +58,7 @@ const color = new Color('black')
 const imageSource: ImageSource = ImageSource.fromFontIconCodeSync(
   '\uf004',
   font,
-  color
+  color,
 )
 ```
 
@@ -206,7 +206,7 @@ Create an ImageSource from the specified local file or resource (if specified wi
 const imageSource: ImageSource = ImageSource.fromFontIconCodeSync(
   source,
   font,
-  color
+  color,
 )
 ```
 

content/core/utils.md

@@ -12,7 +12,7 @@ To verify if a path is valid resource or local file path, use the [isFileOrResou
 
 ```ts
 const isPathValid: boolean = Utils.isFileOrResourcePath(
-  'https://nativescript.org/'
+  'https://nativescript.org/',
 ) //  false
 
 // or
@@ -612,7 +612,7 @@ Gets the string id from a given resource name.
 ```ts
 const paletteColor: number = Utils.android.resources.getPaletteColor(
   resourceName,
-  Utils.android.getApplicationContext()
+  Utils.android.getApplicationContext(),
 )
 ```