@ng-native/nativescript 0.0.0-stage → 0.18.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ashley Hunter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,50 @@
-# Temporary Holding Version
+# @ng-native/nativescript
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Every iOS and Android API from TypeScript, and native views built in TypeScript, through
+[NativeScript](https://nativescript.org)'s runtime.
+
+Alpha: APIs may change before 1.0.
+
+## Install
+
+```sh
+npx expo install @ng-native/nativescript @nativescript/react-native react-native-worklets
+npm install --save-dev @nativescript/types-android
+```
+
+Add `"@ng-native/nativescript"` to the plugins in `app.json`, then rebuild the app: NativeScript
+needs a development build, not Expo Go.
+
+## Example
+
+```ts
+import { Component, inject } from '@angular/core';
+import { Text } from '@ng-native/components';
+import { NativeScript } from '@ng-native/nativescript';
+
+@Component({
+  selector: 'app-device-name',
+  imports: [Text],
+  template: `<text>{{ model }}</text>`,
+})
+export class DeviceName {
+  private readonly native = inject(NativeScript);
+
+  protected readonly model = this.native.call({
+    ios: () => UIDevice.currentDevice.model,
+    android: () => android.os.Build.MODEL,
+  });
+}
+```
+
+With `provideNativeScript()` among the providers `mount` is given.
+
+## What's in the package
+
+- `provideNativeScript()`: installs the runtime, at bootstrap or as a route is entered.
+- `NativeScript`: `call()` on the JavaScript thread, and `runOnUI()` on the main thread.
+- `<ns-view>` and `nsView()`: a UIView or an Android View built in a worklet, sized by the template.
+- `androidContext()`: the Activity to build an Android view with.
+
+The documentation is at
+[ng-native.com/packages/nativescript](https://ng-native.com/packages/nativescript).

package/app.plugin.cjs

@@ -0,0 +1,58 @@
+/**
+ * `"plugins": ["@ng-native/nativescript"]` in app.json: NativeScript's own config plugin, which
+ * links the runtime and its metadata on iOS and applies its Gradle script on Android, without the
+ * Babel config it would write. `@ng-native/metro` supplies that one, with the worklets plugin
+ * configured for NativeScript's globals, so an app has no `babel.config.js` to keep.
+ *
+ * On Android it sets two lines in `gradle.properties`, for a release build, which
+ * `@nativescript/react-native` 9.1.2 can neither build nor run on Expo SDK 58 as it is:
+ *
+ * - `android.enableMinifyInReleaseBuilds=false`, over the `true` SDK 58's prebuild writes. With R8
+ *   on, NativeScript's metadata filtering adds keep rules to a list Android Gradle Plugin 9 makes
+ *   immutable, and the build fails with `UnsupportedOperationException` in `nativescript.gradle`;
+ *   and NativeScript ships no keep rules for its own runtime, so R8 renames the classes its native
+ *   code looks up by name and the app aborts at launch with `JNI DETECTED ERROR: mid == null`.
+ * - `nsSkipStaticBindings=true`. The release task that pre-generates Java for named subclasses
+ *   bundles the app with React Native's CLI, which an Expo app does not have; skipped, those classes
+ *   are generated on the device at startup, as in a debug build.
+ *
+ * Options are NativeScript's, such as `{ "metadata": { "includePods": ["SomeObjCSDK"] } }`.
+ */
+const RELEASE = { 'android.enableMinifyInReleaseBuilds': 'false', nsSkipStaticBindings: 'true' };
+
+// ponytail: drop once @nativescript/react-native ships keep rules AGP 9 accepts and bundles
+// through the app's own React Native CLI (`react.cliFile` and `react.bundleCommand`).
+function releaseProperties(properties) {
+  for (const [key, value] of Object.entries(RELEASE)) {
+    const found = properties.find((entry) => entry.type === 'property' && entry.key === key);
+    if (found) found.value = value;
+    else properties.push({ type: 'property', key, value });
+  }
+  return properties;
+}
+
+module.exports = function withNativeScript(config, options = {}) {
+  const projectRoot = config._internal?.projectRoot ?? process.cwd();
+  let plugin;
+  try {
+    plugin = require(
+      require.resolve('@nativescript/react-native/app.plugin.js', { paths: [projectRoot] }),
+    );
+  } catch (cause) {
+    throw new Error(
+      '[angular-native] @ng-native/nativescript needs @nativescript/react-native. Install it with ' +
+        '"npx expo install @nativescript/react-native react-native-worklets".',
+      { cause },
+    );
+  }
+  const { withGradleProperties } = require(
+    require.resolve('expo/config-plugins', { paths: [projectRoot] }),
+  );
+  const configured = plugin(config, { ...options, babelPlugin: false });
+  return withGradleProperties(configured, (gradle) => {
+    gradle.modResults = releaseProperties(gradle.modResults);
+    return gradle;
+  });
+};
+
+module.exports.releaseProperties = releaseProperties;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './native-script.ts';
+export * from './ns-view.ts';

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./native-script.js";
+export * from "./ns-view.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC","sourcesContent":["export * from './native-script.ts';\nexport * from './ns-view.ts';\n"]}

package/dist/native-script.d.ts

@@ -0,0 +1,100 @@
+/**
+ * NativeScript's runtime, installed once and reached through one service.
+ *
+ * `@nativescript/react-native` puts every iOS SDK symbol and every Android class on the JavaScript
+ * runtime over JSI. The service installs it, picks the function for the platform the app is on, and
+ * says what is wrong in a build without it, so a component does none of that.
+ *
+ * ```ts
+ * bootstrapApplication(App, { providers: [provideNativeScript()] });
+ *
+ * export class DeviceName {
+ *   private readonly native = inject(NativeScript);
+ *   protected readonly model = this.native.call({
+ *     ios: () => UIDevice.currentDevice.model,
+ *     android: () => android.os.Build.MODEL,
+ *   });
+ * }
+ * ```
+ */
+import { InjectionToken, type EnvironmentProviders } from '@angular/core';
+import * as i0 from "@angular/core";
+export type NativeScriptPlatform = 'ios' | 'android';
+/** What the service needs of NativeScript, on the platform the app is on. */
+export interface NativeScriptRuntime {
+    readonly platform: NativeScriptPlatform;
+    /** Install the native API on the JavaScript runtime, with iOS's classes as globals. Idempotent. */
+    install(): void;
+    /** Run a worklet on the platform's main thread. */
+    runOnUI<A extends unknown[], R>(worklet: (...args: A) => R, ...args: A): Promise<R>;
+    /** Load a system framework whose classes the metadata names but the binary does not link. */
+    loadFramework(name: string): boolean;
+    /**
+     * The handle `NativeScriptUIView` shows a view by: a UIView's pointer on iOS, a registry name on
+     * Android. A worklet, so the main thread can be handed it. Throws for a value that is not a view.
+     */
+    nativeViewHandle(view: unknown): string;
+    /** Why there is no runtime on a platform that should have one: a build without it, or Expo Go. */
+    readonly missing?: Error;
+}
+/**
+ * The Context to build an Android view with, the current Activity, as `new
+ * android.widget.TextView(androidContext())` needs. `null` on iOS, in Node, and before NativeScript
+ * is installed. A function of this package's, so a component file can name it without importing
+ * `@nativescript/react-native`, which Node cannot load.
+ */
+export declare function androidContext(): unknown;
+/**
+ * The runtime for the platform the app is on, or null where there is none to install: Node, where
+ * a test runs, and the web. On a device without the native half, Expo Go among them, it is one
+ * that says so as it is used: the rest of the app still runs, and the feature that needs NativeScript
+ * fails with what to do about it, as a missing Expo module does.
+ */
+export declare function nativeScriptRuntime(): NativeScriptRuntime | null;
+/**
+ * NativeScript, installed. Injecting it installs the runtime, once for the process; a test that
+ * renders a component using it gets a service whose `platform` is null and whose calls answer
+ * `undefined`, with no simulator.
+ */
+export declare class NativeScript {
+    /** Overridden in a test to stand in for the native runtime. */
+    static readonly RUNTIME: InjectionToken<NativeScriptRuntime | null>;
+    private readonly runtime;
+    private readonly errors;
+    /** The platform NativeScript is installed on; null in Node and on the web. */
+    readonly platform: NativeScriptPlatform | null;
+    constructor();
+    /**
+     * Call the function for this platform, synchronously, on the JavaScript thread, and answer what
+     * it returns. `undefined` on a platform the object has no function for, and where there is no
+     * runtime. Reading a value or calling a non-UI API is fine here on both platforms; a view is
+     * touched through `runOnUI`. Throws in a build without NativeScript, rather than leave the
+     * function to fail on the first native class it names.
+     */
+    call<T>(calls: {
+        readonly ios?: () => T;
+        readonly android?: () => T;
+    }): T | undefined;
+    /**
+     * Run a worklet on the platform's main thread, where views can be touched, and answer what it
+     * returns. On iOS it runs on the Worklets UI runtime and captures what it reads by value; on
+     * Android it borrows this runtime while the JavaScript thread waits. Either way pass state as
+     * arguments rather than reading `this` inside it.
+     */
+    runOnUI<A extends unknown[], R>(worklet: (...args: A) => R, ...args: A): Promise<R | undefined>;
+    /** The handle `<ns-view>` binds for a view; see `NativeScriptRuntime.nativeViewHandle`. */
+    readonly nativeViewHandle: (view: unknown) => string;
+    /** Load each named system framework (iOS), such as SceneKit. */
+    loadFrameworks(names: readonly string[]): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NativeScript, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+export interface NativeScriptOptions {
+    /** System frameworks to load on iOS before anything under these providers runs. */
+    readonly frameworks?: readonly string[];
+}
+/**
+ * Install NativeScript as these providers' injector is created: at bootstrap for the app's, or as
+ * a route is first entered for a route's, so a feature that needs SceneKit pays for it there.
+ */
+export declare function provideNativeScript(options?: NativeScriptOptions): EnvironmentProviders;

package/dist/native-script.js

@@ -0,0 +1,150 @@
+/**
+ * NativeScript's runtime, installed once and reached through one service.
+ *
+ * `@nativescript/react-native` puts every iOS SDK symbol and every Android class on the JavaScript
+ * runtime over JSI. The service installs it, picks the function for the platform the app is on, and
+ * says what is wrong in a build without it, so a component does none of that.
+ *
+ * ```ts
+ * bootstrapApplication(App, { providers: [provideNativeScript()] });
+ *
+ * export class DeviceName {
+ *   private readonly native = inject(NativeScript);
+ *   protected readonly model = this.native.call({
+ *     ios: () => UIDevice.currentDevice.model,
+ *     android: () => android.os.Build.MODEL,
+ *   });
+ * }
+ * ```
+ */
+import { ErrorHandler, InjectionToken, Service, inject, makeEnvironmentProviders, provideEnvironmentInitializer, } from '@angular/core';
+import * as i0 from "@angular/core";
+/** NativeScript's `androidContext`, once a runtime is made: see `androidContext` below. */
+let contextOf = null;
+/**
+ * The Context to build an Android view with, the current Activity, as `new
+ * android.widget.TextView(androidContext())` needs. `null` on iOS, in Node, and before NativeScript
+ * is installed. A function of this package's, so a component file can name it without importing
+ * `@nativescript/react-native`, which Node cannot load.
+ */
+export function androidContext() {
+    return contextOf?.() ?? null;
+}
+const MISSING = '[angular-native] @nativescript/react-native is not in this build of the app. Install it, add ' +
+    '"@ng-native/nativescript" to the plugins in app.json and rebuild ("npx expo run:ios" or ' +
+    '"npx expo run:android"). Expo Go cannot load it.';
+/**
+ * The runtime for the platform the app is on, or null where there is none to install: Node, where
+ * a test runs, and the web. On a device without the native half, Expo Go among them, it is one
+ * that says so as it is used: the rest of the app still runs, and the feature that needs NativeScript
+ * fails with what to do about it, as a missing Expo module does.
+ */
+export function nativeScriptRuntime() {
+    let platform;
+    try {
+        platform = require('react-native').Platform.OS;
+    }
+    catch {
+        return null;
+    }
+    if (platform !== 'ios' && platform !== 'android')
+        return null;
+    const ns = require('@nativescript/react-native').default;
+    if (!ns.isAvailable()) {
+        const missing = new Error(MISSING);
+        return {
+            platform,
+            missing,
+            install: () => { },
+            runOnUI: () => Promise.reject(missing),
+            loadFramework: () => true,
+            nativeViewHandle: () => {
+                throw missing;
+            },
+        };
+    }
+    contextOf = platform === 'android' ? ns.androidContext : null;
+    return {
+        platform,
+        // Globals on iOS: `UIDevice.currentDevice` rather than `NativeScript.getClass('UIDevice')`. The
+        // package defaults them off so UIKit is not touched from the JavaScript thread by accident;
+        // `runOnUI` is still the way to touch a view. Android's packages are globals either way.
+        install: () => void ns.init('', { globals: platform === 'ios' }),
+        runOnUI: (worklet, ...args) => ns.runOnUI(worklet, ...args),
+        // Android loads classes from the APK's classpath; there is nothing to load.
+        loadFramework: (name) => platform !== 'ios' || ns.loadFramework(name),
+        nativeViewHandle: ns.nativeViewHandle,
+    };
+}
+/** Where there is no runtime. A worklet, as the runtime's own is; an object, as `nsView` explains. */
+const noRuntime = {
+    nativeViewHandle(view) {
+        'worklet';
+        throw new Error(`[angular-native] No NativeScript runtime to take ${String(view)}'s handle.`);
+    },
+};
+/**
+ * NativeScript, installed. Injecting it installs the runtime, once for the process; a test that
+ * renders a component using it gets a service whose `platform` is null and whose calls answer
+ * `undefined`, with no simulator.
+ */
+export class NativeScript {
+    /** Overridden in a test to stand in for the native runtime. */
+    static RUNTIME = new InjectionToken('angular-native.nativeScriptRuntime', { factory: nativeScriptRuntime });
+    runtime = inject(NativeScript.RUNTIME);
+    errors = inject(ErrorHandler);
+    /** The platform NativeScript is installed on; null in Node and on the web. */
+    platform = this.runtime?.platform ?? null;
+    constructor() {
+        this.runtime?.install();
+    }
+    /**
+     * Call the function for this platform, synchronously, on the JavaScript thread, and answer what
+     * it returns. `undefined` on a platform the object has no function for, and where there is no
+     * runtime. Reading a value or calling a non-UI API is fine here on both platforms; a view is
+     * touched through `runOnUI`. Throws in a build without NativeScript, rather than leave the
+     * function to fail on the first native class it names.
+     */
+    call(calls) {
+        const call = this.platform && calls[this.platform];
+        if (call && this.runtime?.missing)
+            throw this.runtime.missing;
+        return call ? call() : undefined;
+    }
+    /**
+     * Run a worklet on the platform's main thread, where views can be touched, and answer what it
+     * returns. On iOS it runs on the Worklets UI runtime and captures what it reads by value; on
+     * Android it borrows this runtime while the JavaScript thread waits. Either way pass state as
+     * arguments rather than reading `this` inside it.
+     */
+    runOnUI(worklet, ...args) {
+        return this.runtime ? this.runtime.runOnUI(worklet, ...args) : Promise.resolve(undefined);
+    }
+    /** The handle `<ns-view>` binds for a view; see `NativeScriptRuntime.nativeViewHandle`. */
+    nativeViewHandle = this.runtime?.nativeViewHandle ?? noRuntime.nativeViewHandle;
+    /** Load each named system framework (iOS), such as SceneKit. */
+    loadFrameworks(names) {
+        if (this.platform !== 'ios')
+            return;
+        for (const name of names) {
+            if (!this.runtime.loadFramework(name)) {
+                this.errors.handleError(new Error(`[angular-native] NativeScript could not load ${name}.`));
+            }
+        }
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: NativeScript, deps: [], target: i0.ɵɵFactoryTarget.Service });
+    static ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.2.0", ngImport: i0, type: NativeScript });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: NativeScript, decorators: [{
+            type: Service
+        }], ctorParameters: () => [] });
+/**
+ * Install NativeScript as these providers' injector is created: at bootstrap for the app's, or as
+ * a route is first entered for a route's, so a feature that needs SceneKit pays for it there.
+ */
+export function provideNativeScript(options = {}) {
+    return makeEnvironmentProviders([
+        provideEnvironmentInitializer(() => inject(NativeScript).loadFrameworks(options.frameworks ?? [])),
+    ]);
+}
+//# sourceMappingURL=native-script.js.map

package/dist/native-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-script.js","sourceRoot":"","sources":["../src/native-script.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * NativeScript's runtime, installed once and reached through one service.\n *\n * `@nativescript/react-native` puts every iOS SDK symbol and every Android class on the JavaScript\n * runtime over JSI. The service installs it, picks the function for the platform the app is on, and\n * says what is wrong in a build without it, so a component does none of that.\n *\n * ```ts\n * bootstrapApplication(App, { providers: [provideNativeScript()] });\n *\n * export class DeviceName {\n *   private readonly native = inject(NativeScript);\n *   protected readonly model = this.native.call({\n *     ios: () => UIDevice.currentDevice.model,\n *     android: () => android.os.Build.MODEL,\n *   });\n * }\n * ```\n */\nimport {\n  ErrorHandler,\n  InjectionToken,\n  Service,\n  inject,\n  makeEnvironmentProviders,\n  provideEnvironmentInitializer,\n  type EnvironmentProviders,\n} from '@angular/core';\n\nexport type NativeScriptPlatform = 'ios' | 'android';\n\n/** What the service needs of NativeScript, on the platform the app is on. */\nexport interface NativeScriptRuntime {\n  readonly platform: NativeScriptPlatform;\n  /** Install the native API on the JavaScript runtime, with iOS's classes as globals. Idempotent. */\n  install(): void;\n  /** Run a worklet on the platform's main thread. */\n  runOnUI<A extends unknown[], R>(worklet: (...args: A) => R, ...args: A): Promise<R>;\n  /** Load a system framework whose classes the metadata names but the binary does not link. */\n  loadFramework(name: string): boolean;\n  /**\n   * The handle `NativeScriptUIView` shows a view by: a UIView's pointer on iOS, a registry name on\n   * Android. A worklet, so the main thread can be handed it. Throws for a value that is not a view.\n   */\n  nativeViewHandle(view: unknown): string;\n  /** Why there is no runtime on a platform that should have one: a build without it, or Expo Go. */\n  readonly missing?: Error;\n}\n\n/** The subset of `@nativescript/react-native`'s default export used here. */\ninterface NativeScriptModule {\n  isAvailable(): boolean;\n  init(metadataPath?: string, options?: { globals?: boolean }): boolean;\n  runOnUI<A extends unknown[], R>(worklet: (...args: A) => R, ...args: A): Promise<R>;\n  loadFramework(name: string): boolean;\n  nativeViewHandle(view: unknown): string;\n  androidContext(): unknown;\n}\n\n/** NativeScript's `androidContext`, once a runtime is made: see `androidContext` below. */\nlet contextOf: (() => unknown) | null = null;\n\n/**\n * The Context to build an Android view with, the current Activity, as `new\n * android.widget.TextView(androidContext())` needs. `null` on iOS, in Node, and before NativeScript\n * is installed. A function of this package's, so a component file can name it without importing\n * `@nativescript/react-native`, which Node cannot load.\n */\nexport function androidContext(): unknown {\n  return contextOf?.() ?? null;\n}\n\nconst MISSING =\n  '[angular-native] @nativescript/react-native is not in this build of the app. Install it, add ' +\n  '\"@ng-native/nativescript\" to the plugins in app.json and rebuild (\"npx expo run:ios\" or ' +\n  '\"npx expo run:android\"). Expo Go cannot load it.';\n\n/**\n * The runtime for the platform the app is on, or null where there is none to install: Node, where\n * a test runs, and the web. On a device without the native half, Expo Go among them, it is one\n * that says so as it is used: the rest of the app still runs, and the feature that needs NativeScript\n * fails with what to do about it, as a missing Expo module does.\n */\nexport function nativeScriptRuntime(): NativeScriptRuntime | null {\n  let platform: string;\n  try {\n    platform = (require('react-native') as { Platform: { OS: string } }).Platform.OS;\n  } catch {\n    return null;\n  }\n  if (platform !== 'ios' && platform !== 'android') return null;\n  const ns = (require('@nativescript/react-native') as { default: NativeScriptModule }).default;\n  if (!ns.isAvailable()) {\n    const missing = new Error(MISSING);\n    return {\n      platform,\n      missing,\n      install: () => {},\n      runOnUI: () => Promise.reject(missing),\n      loadFramework: () => true,\n      nativeViewHandle: () => {\n        throw missing;\n      },\n    };\n  }\n  contextOf = platform === 'android' ? ns.androidContext : null;\n  return {\n    platform,\n    // Globals on iOS: `UIDevice.currentDevice` rather than `NativeScript.getClass('UIDevice')`. The\n    // package defaults them off so UIKit is not touched from the JavaScript thread by accident;\n    // `runOnUI` is still the way to touch a view. Android's packages are globals either way.\n    install: () => void ns.init('', { globals: platform === 'ios' }),\n    runOnUI: (worklet, ...args) => ns.runOnUI(worklet, ...args),\n    // Android loads classes from the APK's classpath; there is nothing to load.\n    loadFramework: (name) => platform !== 'ios' || ns.loadFramework(name),\n    nativeViewHandle: ns.nativeViewHandle,\n  };\n}\n\n/** Where there is no runtime. A worklet, as the runtime's own is; an object, as `nsView` explains. */\nconst noRuntime = {\n  nativeViewHandle(view: unknown): string {\n    'worklet';\n    throw new Error(`[angular-native] No NativeScript runtime to take ${String(view)}'s handle.`);\n  },\n};\n\n/**\n * NativeScript, installed. Injecting it installs the runtime, once for the process; a test that\n * renders a component using it gets a service whose `platform` is null and whose calls answer\n * `undefined`, with no simulator.\n */\n@Service()\nexport class NativeScript {\n  /** Overridden in a test to stand in for the native runtime. */\n  static readonly RUNTIME = new InjectionToken<NativeScriptRuntime | null>(\n    'angular-native.nativeScriptRuntime',\n    { factory: nativeScriptRuntime },\n  );\n\n  private readonly runtime = inject(NativeScript.RUNTIME);\n  private readonly errors = inject(ErrorHandler);\n\n  /** The platform NativeScript is installed on; null in Node and on the web. */\n  readonly platform: NativeScriptPlatform | null = this.runtime?.platform ?? null;\n\n  constructor() {\n    this.runtime?.install();\n  }\n\n  /**\n   * Call the function for this platform, synchronously, on the JavaScript thread, and answer what\n   * it returns. `undefined` on a platform the object has no function for, and where there is no\n   * runtime. Reading a value or calling a non-UI API is fine here on both platforms; a view is\n   * touched through `runOnUI`. Throws in a build without NativeScript, rather than leave the\n   * function to fail on the first native class it names.\n   */\n  call<T>(calls: { readonly ios?: () => T; readonly android?: () => T }): T | undefined {\n    const call = this.platform && calls[this.platform];\n    if (call && this.runtime?.missing) throw this.runtime.missing;\n    return call ? call() : undefined;\n  }\n\n  /**\n   * Run a worklet on the platform's main thread, where views can be touched, and answer what it\n   * returns. On iOS it runs on the Worklets UI runtime and captures what it reads by value; on\n   * Android it borrows this runtime while the JavaScript thread waits. Either way pass state as\n   * arguments rather than reading `this` inside it.\n   */\n  runOnUI<A extends unknown[], R>(worklet: (...args: A) => R, ...args: A): Promise<R | undefined> {\n    return this.runtime ? this.runtime.runOnUI(worklet, ...args) : Promise.resolve(undefined);\n  }\n\n  /** The handle `<ns-view>` binds for a view; see `NativeScriptRuntime.nativeViewHandle`. */\n  readonly nativeViewHandle: (view: unknown) => string =\n    this.runtime?.nativeViewHandle ?? noRuntime.nativeViewHandle;\n\n  /** Load each named system framework (iOS), such as SceneKit. */\n  loadFrameworks(names: readonly string[]): void {\n    if (this.platform !== 'ios') return;\n    for (const name of names) {\n      if (!this.runtime!.loadFramework(name)) {\n        this.errors.handleError(new Error(`[angular-native] NativeScript could not load ${name}.`));\n      }\n    }\n  }\n}\n\nexport interface NativeScriptOptions {\n  /** System frameworks to load on iOS before anything under these providers runs. */\n  readonly frameworks?: readonly string[];\n}\n\n/**\n * Install NativeScript as these providers' injector is created: at bootstrap for the app's, or as\n * a route is first entered for a route's, so a feature that needs SceneKit pays for it there.\n */\nexport function provideNativeScript(options: NativeScriptOptions = {}): EnvironmentProviders {\n  return makeEnvironmentProviders([\n    provideEnvironmentInitializer(() =>\n      inject(NativeScript).loadFrameworks(options.frameworks ?? []),\n    ),\n  ]);\n}\n"]}

package/dist/ns-view.d.ts

@@ -0,0 +1,25 @@
+import * as i0 from "@angular/core";
+/** How to build a native view and keep it in step with its props. Both functions are worklets. */
+export interface NsViewSpec<P, V> {
+    create(props: P): V;
+    update?(view: V, props: P): void;
+}
+/**
+ * Declare a native view. An identity function, there to infer `P` and `V` across both functions;
+ * written as an object so the HMR transform, which wraps a module's top-level functions and with
+ * them a worklet's `__workletHash`, leaves the worklets alone.
+ */
+export declare function nsView<P, V>(spec: NsViewSpec<P, V>): NsViewSpec<P, V>;
+export declare class NsView<P = unknown> {
+    private readonly native;
+    private readonly errors;
+    /** What to build. A different spec builds a new view in place of the old one. */
+    readonly view: import("@angular/core").InputSignal<NsViewSpec<P, any>>;
+    /** Passed to `create`, then to `update` each time it changes. Copied to iOS's UI runtime. */
+    readonly props: import("@angular/core").InputSignal<P>;
+    /** The view's pointer; `null` once it is gone, since a prop set to `undefined` is not removed. */
+    protected readonly handle: import("@angular/core").WritableSignal<string | null | undefined>;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<NsView<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NsView<any>, "ns-view", never, { "view": { "alias": "view"; "required": true; "isSignal": true; }; "props": { "alias": "props"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/dist/ns-view.js

@@ -0,0 +1,137 @@
+/**
+ * `<ns-view>`: a native view built in TypeScript, a UIView or an `android.view.View`, laid out by the
+ * template like any other view.
+ *
+ * ```ts
+ * const badge = nsView<{ title: string }, UILabel>({
+ *   create(props) {
+ *     'worklet';
+ *     const label = UILabel.new();
+ *     label.text = props.title;
+ *     return label;
+ *   },
+ *   update(label, props) {
+ *     'worklet';
+ *     label.text = props.title;
+ *   },
+ * });
+ *
+ * @Component({
+ *   imports: [NsView],
+ *   template: `<ns-view class="h-12" [view]="badge" [props]="{ title: title() }" />`,
+ * })
+ * ```
+ *
+ * `@nativescript/react-native` ships a Fabric view, `NativeScriptUIView`, on both platforms, that
+ * shows the view whose handle it is given as `nativeViewHandle`. The element commits as that view;
+ * `create` runs on the main thread, the view it returns is kept there under the element's id, and
+ * its handle comes back to be bound. `update` runs there too, each time `props` changes. The
+ * package's own `defineUIKitView` does the same for React, and is a React component, so it cannot be
+ * used here.
+ */
+import { Component, DestroyRef, ErrorHandler, effect, inject, input, signal } from '@angular/core';
+import { registerViewName } from '@ng-native/fabric';
+import { NativeScript } from "./native-script.js";
+import * as i0 from "@angular/core";
+/**
+ * Declare a native view. An identity function, there to infer `P` and `V` across both functions;
+ * written as an object so the HMR transform, which wraps a module's top-level functions and with
+ * them a worklet's `__workletHash`, leaves the worklets alone.
+ */
+export function nsView(spec) {
+    return spec;
+}
+registerViewName('ns-view', 'NativeScriptUIView', { collapsable: false });
+/** The views built so far, on the main thread's runtime, keyed by element. Holding one keeps it alive. */
+const VIEWS = '__ngNsViews';
+/** Runs on the main thread. One object so none of these is a top-level function: see `nsView`. */
+const ui = {
+    mount(id, create, props, handleOf) {
+        'worklet';
+        const g = globalThis;
+        const views = (g[VIEWS] ??= new Map());
+        // The view this element showed goes first, so a create that fails leaves it empty.
+        views.delete(id);
+        const view = create(props);
+        // iOS takes any NSObject's pointer, a controller's too, and shows nothing for one that is not
+        // a UIView, so that is checked here; Android's handle refuses what is not a View itself.
+        const notAView = g['UIView'] && view?.isKindOfClass?.(g['UIView']) !== true;
+        let handle;
+        try {
+            if (!notAView && view != null)
+                handle = handleOf(view);
+        }
+        catch {
+            // Reported below, as the value it was.
+        }
+        if (handle === undefined) {
+            throw new Error(`[angular-native] An nsView's create returned ${String(view)}, where it returns a view.`);
+        }
+        views.set(id, view);
+        return handle;
+    },
+    update(id, update, props) {
+        'worklet';
+        const view = globalThis[VIEWS]?.get(id);
+        if (view)
+            update(view, props);
+    },
+    unmount(id) {
+        'worklet';
+        globalThis[VIEWS]?.delete(id);
+    },
+};
+let nextId = 0;
+export class NsView {
+    native = inject(NativeScript);
+    errors = inject(ErrorHandler);
+    /** What to build. A different spec builds a new view in place of the old one. */
+    view = input.required(/* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "view" }] : /* istanbul ignore next */ []));
+    /** Passed to `create`, then to `update` each time it changes. Copied to iOS's UI runtime. */
+    props = input.required(/* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "props" }] : /* istanbul ignore next */ []));
+    /** The view's pointer; `null` once it is gone, since a prop set to `undefined` is not removed. */
+    handle = signal(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "handle" }] : /* istanbul ignore next */ []));
+    constructor() {
+        const id = `ns-view-${nextId++}`;
+        const report = (error) => this.errors.handleError(error);
+        let built;
+        effect(() => {
+            const spec = this.view();
+            const props = this.props();
+            if (!this.native.platform)
+                return;
+            if (spec !== built) {
+                built = spec;
+                const create = spec.create;
+                this.native.runOnUI(ui.mount, id, create, props, this.native.nativeViewHandle).then((handle) => built === spec && this.handle.set(handle), (error) => {
+                    if (built === spec)
+                        this.handle.set(null);
+                    report(error);
+                });
+            }
+            else if (spec.update) {
+                this.native
+                    .runOnUI(ui.update, id, spec.update, props)
+                    .catch(report);
+            }
+        });
+        inject(DestroyRef).onDestroy(() => {
+            if (built)
+                this.native.runOnUI(ui.unmount, id).catch(report);
+        });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: NsView, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.2.0", type: NsView, isStandalone: true, selector: "ns-view", inputs: { view: { classPropertyName: "view", publicName: "view", isSignal: true, isRequired: true, transformFunction: null }, props: { classPropertyName: "props", publicName: "props", isSignal: true, isRequired: true, transformFunction: null } }, host: { properties: { "nativeViewHandle": "handle()" } }, ngImport: i0, template: '', isInline: true });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: NsView, decorators: [{
+            type: Component,
+            args: [{
+                    selector: 'ns-view',
+                    template: '',
+                    host: { '[nativeViewHandle]': 'handle()' },
+                }]
+        }], ctorParameters: () => [], propDecorators: { view: [{ type: i0.Input, args: [{ isSignal: true, alias: "view", required: true }] }], props: [{ type: i0.Input, args: [{ isSignal: true, alias: "props", required: true }] }] } });
+//# sourceMappingURL=ns-view.js.map

package/dist/ns-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ns-view.js","sourceRoot":"","sources":["../src/ns-view.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `<ns-view>`: a native view built in TypeScript, a UIView or an `android.view.View`, laid out by the\n * template like any other view.\n *\n * ```ts\n * const badge = nsView<{ title: string }, UILabel>({\n *   create(props) {\n *     'worklet';\n *     const label = UILabel.new();\n *     label.text = props.title;\n *     return label;\n *   },\n *   update(label, props) {\n *     'worklet';\n *     label.text = props.title;\n *   },\n * });\n *\n * @Component({\n *   imports: [NsView],\n *   template: `<ns-view class=\"h-12\" [view]=\"badge\" [props]=\"{ title: title() }\" />`,\n * })\n * ```\n *\n * `@nativescript/react-native` ships a Fabric view, `NativeScriptUIView`, on both platforms, that\n * shows the view whose handle it is given as `nativeViewHandle`. The element commits as that view;\n * `create` runs on the main thread, the view it returns is kept there under the element's id, and\n * its handle comes back to be bound. `update` runs there too, each time `props` changes. The\n * package's own `defineUIKitView` does the same for React, and is a React component, so it cannot be\n * used here.\n */\nimport { Component, DestroyRef, ErrorHandler, effect, inject, input, signal } from '@angular/core';\nimport { registerViewName } from '@ng-native/fabric';\nimport { NativeScript } from './native-script.ts';\n\n/** How to build a native view and keep it in step with its props. Both functions are worklets. */\nexport interface NsViewSpec<P, V> {\n  create(props: P): V;\n  update?(view: V, props: P): void;\n}\n\n/**\n * Declare a native view. An identity function, there to infer `P` and `V` across both functions;\n * written as an object so the HMR transform, which wraps a module's top-level functions and with\n * them a worklet's `__workletHash`, leaves the worklets alone.\n */\nexport function nsView<P, V>(spec: NsViewSpec<P, V>): NsViewSpec<P, V> {\n  return spec;\n}\n\nregisterViewName('ns-view', 'NativeScriptUIView', { collapsable: false });\n\n/** The views built so far, on the main thread's runtime, keyed by element. Holding one keeps it alive. */\nconst VIEWS = '__ngNsViews';\n\n/** Runs on the main thread. One object so none of these is a top-level function: see `nsView`. */\nconst ui = {\n  mount(\n    id: string,\n    create: (props: unknown) => unknown,\n    props: unknown,\n    handleOf: (view: unknown) => string,\n  ): string {\n    'worklet';\n    const g = globalThis as Record<string, any>;\n    const views: Map<string, unknown> = (g[VIEWS] ??= new Map());\n    // The view this element showed goes first, so a create that fails leaves it empty.\n    views.delete(id);\n    const view = create(props) as { isKindOfClass?(of: unknown): boolean } | null;\n    // iOS takes any NSObject's pointer, a controller's too, and shows nothing for one that is not\n    // a UIView, so that is checked here; Android's handle refuses what is not a View itself.\n    const notAView = g['UIView'] && view?.isKindOfClass?.(g['UIView']) !== true;\n    let handle: string | undefined;\n    try {\n      if (!notAView && view != null) handle = handleOf(view);\n    } catch {\n      // Reported below, as the value it was.\n    }\n    if (handle === undefined) {\n      throw new Error(\n        `[angular-native] An nsView's create returned ${String(view)}, where it returns a view.`,\n      );\n    }\n    views.set(id, view);\n    return handle;\n  },\n  update(id: string, update: (view: unknown, props: unknown) => void, props: unknown): void {\n    'worklet';\n    const view = (globalThis as Record<string, any>)[VIEWS]?.get(id);\n    if (view) update(view, props);\n  },\n  unmount(id: string): void {\n    'worklet';\n    (globalThis as Record<string, any>)[VIEWS]?.delete(id);\n  },\n};\n\nlet nextId = 0;\n\n@Component({\n  selector: 'ns-view',\n  template: '',\n  host: { '[nativeViewHandle]': 'handle()' },\n})\nexport class NsView<P = unknown> {\n  private readonly native = inject(NativeScript);\n  private readonly errors = inject(ErrorHandler);\n\n  /** What to build. A different spec builds a new view in place of the old one. */\n  readonly view = input.required<NsViewSpec<P, any>>();\n  /** Passed to `create`, then to `update` each time it changes. Copied to iOS's UI runtime. */\n  readonly props = input.required<P>();\n\n  /** The view's pointer; `null` once it is gone, since a prop set to `undefined` is not removed. */\n  protected readonly handle = signal<string | null | undefined>(undefined);\n\n  constructor() {\n    const id = `ns-view-${nextId++}`;\n    const report = (error: unknown) => this.errors.handleError(error);\n    let built: NsViewSpec<P, any> | undefined;\n\n    effect(() => {\n      const spec = this.view();\n      const props = this.props();\n      if (!this.native.platform) return;\n      if (spec !== built) {\n        built = spec;\n        const create = spec.create as (props: unknown) => unknown;\n        this.native.runOnUI(ui.mount, id, create, props, this.native.nativeViewHandle).then(\n          (handle) => built === spec && this.handle.set(handle),\n          (error: unknown) => {\n            if (built === spec) this.handle.set(null);\n            report(error);\n          },\n        );\n      } else if (spec.update) {\n        this.native\n          .runOnUI(ui.update, id, spec.update as (view: unknown, props: unknown) => void, props)\n          .catch(report);\n      }\n    });\n\n    inject(DestroyRef).onDestroy(() => {\n      if (built) this.native.runOnUI(ui.unmount, id).catch(report);\n    });\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,70 @@
 {
   "name": "@ng-native/nativescript",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.18.2",
+  "description": "NativeScript's iOS and Android APIs in Angular Native: provideNativeScript, a NativeScript service and a <native-view> for a UIView built in TypeScript.",
+  "keywords": [
+    "angular",
+    "react-native",
+    "angular-native",
+    "nativescript",
+    "ios",
+    "android",
+    "jsi"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "dependencies": {
+    "@ng-native/fabric": "0.18.2"
+  },
+  "peerDependencies": {
+    "@angular/core": "^22.0.0",
+    "@nativescript/react-native": "^9.1.2",
+    "react-native": ">=0.86.0",
+    "react-native-worklets": ">=0.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native": {
+      "optional": true
+    }
+  },
+  "nx": {
+    "tags": [
+      "scope:nativescript",
+      "layer:angular"
+    ]
+  },
+  "license": "MIT",
+  "homepage": "https://ng-native.com/guide/native-modules/nativescript",
+  "bugs": {
+    "url": "https://github.com/ng-native/ng-native/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ng-native/ng-native.git",
+    "directory": "packages/nativescript"
+  },
+  "files": [
+    "dist",
+    "app.plugin.cjs"
+  ],
+  "devDependencies": {
+    "@angular/core": "22.2.0",
+    "@babel/core": "^7.29.7"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./app.plugin.cjs": "./app.plugin.cjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "ngc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "types": "dist/index.d.ts"
 }