@symbiote-native/constants 3.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 A. Prokopenko
+
+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

@@ -0,0 +1,90 @@
+# @symbiote-native/constants
+
+A wrapper package for [SymbioteNative](../../README.md) that makes
+[`expo-constants`](https://github.com/expo/expo/tree/main/packages/expo-constants), trimmed to its
+native fields, usable from **every** adapter: React, Vue, Svelte, Solid and Angular. Every field is
+a plain value resolved once from the native module, so there is no hook, composable or service to
+wrap: each adapter entry point re-exports the same `core`.
+
+## Install
+
+**New app:**
+
+```bash
+npx @symbiote-native/cli new my-app --constants
+```
+
+**Existing SymbioteNative app:**
+
+```bash
+npx @symbiote-native/cli add --constants
+```
+
+Either way it installs `@symbiote-native/constants` and wires the native autolinking, see
+[`@symbiote-native/cli`](../cli). `expo-constants` and `expo-modules-core` come along as pinned
+dependencies: never install either yourself and never add the `expo` meta-package.
+
+Autolinking is the same one-time `expo-modules-core` setup every Expo wrapper needs, see the
+`symbiote-expo-native-module` project skill. On Android the package also registers
+`ConstantsService`, the native provider the module reads its values from: without it the module
+resolves but every field is empty.
+
+## Use it
+
+```ts
+import { Constants, ExecutionEnvironment } from '@symbiote-native/constants';
+
+Constants.sessionId; // string, new on every app launch
+Constants.statusBarHeight; // number
+Constants.systemFonts; // string[]
+Constants.linkingUri; // string
+Constants.executionEnvironment === ExecutionEnvironment.Bare; // boolean
+await Constants.getWebViewUserAgentAsync(); // string | null
+```
+
+`./react`, `./vue`, `./svelte` and `./solid` are `exports`-map aliases onto `src/core/`, and
+`./angular` is a physical file only because Angular ships through a separate `ngc` build.
+
+## API
+
+`Constants` (`IConstants`): `appOwnership`, `debugMode`, `deviceName`, `deviceYearClass`,
+`executionEnvironment`, `experienceUrl`, `expoRuntimeVersion`, `expoVersion`, `isDetached`,
+`intentUri`, `isHeadless`, `linkingUri`, `sessionId`, `statusBarHeight`, `systemFonts`,
+`systemVersion`, `supportedExpoSdks`, `platform` (`ios` with `buildNumber`, `platform`, `model`,
+`userInterfaceIdiom`, `systemVersion`; `android` with `versionCode`) and `getWebViewUserAgentAsync()`.
+
+Plus the enums `AppOwnership`, `ExecutionEnvironment` and `UserInterfaceIdiom`, and
+`createConstants(nativeModule)`, the function `Constants` is built with.
+
+## Not ported
+
+- **The manifest family**: `manifest`, `manifest2`, `expoConfig`, `expoGoConfig` and `easConfig`.
+  Upstream reads them from an app manifest that `expo-cli`, EAS or `expo-updates` generate, and
+  this project has none. `createConstants` drops them even when the native module reports one.
+- **`expo-updates` and dev-launcher manifest lookup**, for the same reason.
+- **The web implementation** (`ExponentConstants.web.ts`) and the server entry, this project
+  targets iOS and Android only.
+
+The upstream tests all cover the manifest and are not ported, except its linking URI check, which
+has a counterpart in `constants.test.ts`.
+
+Because the manifest is missing, this package does not unlock `expo-auth-session`'s `auth.expo.io`
+proxy flow or the scheme auto-detection of `makeRedirectUri`: both read `Constants.expoConfig`.
+
+## Common questions
+
+- **Where is `Constants.expoConfig`?** Not ported (no Expo manifest here); inline build-time values
+  through your own Babel or Metro config.
+- **`Constants.manifest` is `null`.** Deprecated upstream and not available here.
+- **Where is `installationId`?** Deprecated upstream; use `@symbiote-native/application`'s Android ID
+  or a stored id in `@symbiote-native/secure-store`.
+- **`makeRedirectUri` needs a scheme.** Pass `scheme` explicitly.
+
+Sources: [Expo docs: Constants](https://docs.expo.dev/versions/latest/sdk/constants/),
+[expo/expo#44527](https://github.com/expo/expo/issues/44527).
+
+## Test it
+
+Tests inject a fake native module in place of the real `requireNativeModule` resolution
+(`src/core/constants.test.ts`, `vitest`), the same pattern as
+[`@symbiote-native/application`](../application). Values on a real device are verified on-device.

package/build/angular/index.d.ts

@@ -0,0 +1 @@
+export * from '../core';

package/build/angular/index.js

@@ -0,0 +1,3 @@
+// @symbiote-native/constants/angular: the Angular entry over the framework-agnostic core
+// Nothing here is per-instance or event-driven, so there is no service to wrap, plain re-export
+export * from '../core/index.js';

package/build/core/constants.d.ts

@@ -0,0 +1,5 @@
+import type { INativeConstantsModule } from './native-module';
+import type { IConstants } from './types';
+/** The native fields of the `ExponentConstants` module, without the Expo manifest family */
+export declare function createConstants(native: INativeConstantsModule): IConstants;
+export declare const Constants: IConstants;

package/build/core/constants.js

@@ -0,0 +1,19 @@
+import { UnavailabilityError } from 'expo-modules-core';
+import { expoConstants } from './native-module.js';
+const NATIVE_MODULE_NAME = 'expo-constants';
+/** The native fields of the `ExponentConstants` module, without the Expo manifest family */
+export function createConstants(native) {
+    const { name, appOwnership, manifest, manifest2, expoConfig, expoGoConfig, easConfig, getWebViewUserAgentAsync, ...nativeFields } = native;
+    return {
+        ...nativeFields,
+        // Ensure this is null in bare workflow
+        appOwnership: appOwnership ?? null,
+        async getWebViewUserAgentAsync() {
+            if (!getWebViewUserAgentAsync) {
+                throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getWebViewUserAgentAsync');
+            }
+            return getWebViewUserAgentAsync();
+        },
+    };
+}
+export const Constants = createConstants(expoConstants);

package/build/core/index.d.ts

@@ -0,0 +1,2 @@
+export { Constants, createConstants } from './constants';
+export { AppOwnership, ExecutionEnvironment, UserInterfaceIdiom, type IAndroidPlatformConstants, type IConstants, type IIosPlatformConstants, type IPlatformConstants, } from './types';

package/build/core/index.js

@@ -0,0 +1,2 @@
+export { Constants, createConstants } from './constants.js';
+export { AppOwnership, ExecutionEnvironment, UserInterfaceIdiom, } from './types.js';

package/build/core/native-module.d.ts

@@ -0,0 +1,12 @@
+import type { AppOwnership, IConstants } from './types';
+export type INativeConstantsModule = Omit<IConstants, 'appOwnership' | 'getWebViewUserAgentAsync'> & {
+    name?: string;
+    appOwnership?: AppOwnership | null;
+    manifest?: unknown;
+    manifest2?: unknown;
+    expoConfig?: unknown;
+    expoGoConfig?: unknown;
+    easConfig?: unknown;
+    getWebViewUserAgentAsync?: () => Promise<string | null>;
+};
+export declare const expoConstants: INativeConstantsModule;

package/build/core/native-module.js

@@ -0,0 +1,3 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPONENT_CONSTANTS_MODULE_NAME = 'ExponentConstants';
+export const expoConstants = requireNativeModule(EXPONENT_CONSTANTS_MODULE_NAME);

package/build/core/types.d.ts

@@ -0,0 +1,52 @@
+export declare enum AppOwnership {
+    Expo = "expo"
+}
+export declare enum ExecutionEnvironment {
+    Bare = "bare",
+    Standalone = "standalone",
+    StoreClient = "storeClient"
+}
+export declare enum UserInterfaceIdiom {
+    Handset = "handset",
+    Tablet = "tablet",
+    Desktop = "desktop",
+    TV = "tv",
+    Unsupported = "unsupported"
+}
+/** @platform ios */
+export type IIosPlatformConstants = {
+    buildNumber: string | null;
+    platform: string;
+    model: string | null;
+    userInterfaceIdiom: UserInterfaceIdiom;
+    systemVersion: string;
+};
+/** @platform android */
+export type IAndroidPlatformConstants = {
+    versionCode: number;
+};
+export type IPlatformConstants = {
+    ios?: IIosPlatformConstants;
+    android?: IAndroidPlatformConstants;
+};
+export type IConstants = {
+    appOwnership: AppOwnership | null;
+    debugMode: boolean;
+    deviceName?: string;
+    deviceYearClass: number | null;
+    executionEnvironment: ExecutionEnvironment;
+    experienceUrl: string;
+    expoRuntimeVersion: string | null;
+    expoVersion: string | null;
+    isDetached?: boolean;
+    intentUri?: string;
+    isHeadless: boolean;
+    linkingUri: string;
+    sessionId: string;
+    statusBarHeight: number;
+    systemFonts: string[];
+    systemVersion?: number;
+    supportedExpoSdks?: string[];
+    platform?: IPlatformConstants;
+    getWebViewUserAgentAsync: () => Promise<string | null>;
+};

package/build/core/types.js

@@ -0,0 +1,18 @@
+export var AppOwnership;
+(function (AppOwnership) {
+    AppOwnership["Expo"] = "expo";
+})(AppOwnership || (AppOwnership = {}));
+export var ExecutionEnvironment;
+(function (ExecutionEnvironment) {
+    ExecutionEnvironment["Bare"] = "bare";
+    ExecutionEnvironment["Standalone"] = "standalone";
+    ExecutionEnvironment["StoreClient"] = "storeClient";
+})(ExecutionEnvironment || (ExecutionEnvironment = {}));
+export var UserInterfaceIdiom;
+(function (UserInterfaceIdiom) {
+    UserInterfaceIdiom["Handset"] = "handset";
+    UserInterfaceIdiom["Tablet"] = "tablet";
+    UserInterfaceIdiom["Desktop"] = "desktop";
+    UserInterfaceIdiom["TV"] = "tv";
+    UserInterfaceIdiom["Unsupported"] = "unsupported";
+})(UserInterfaceIdiom || (UserInterfaceIdiom = {}));

package/build-ngc/angular/index.d.ts

@@ -0,0 +1 @@
+export * from '../core';

package/build-ngc/angular/index.js

@@ -0,0 +1,4 @@
+// @symbiote-native/constants/angular: the Angular entry over the framework-agnostic core
+// Nothing here is per-instance or event-driven, so there is no service to wrap, plain re-export
+export * from '../core';
+//# sourceMappingURL=index.js.map

package/build-ngc/angular/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,gGAAgG;AAChG,cAAc,SAAS,CAAC"}

package/build-ngc/core/constants.d.ts

@@ -0,0 +1,5 @@
+import type { INativeConstantsModule } from './native-module';
+import type { IConstants } from './types';
+/** The native fields of the `ExponentConstants` module, without the Expo manifest family */
+export declare function createConstants(native: INativeConstantsModule): IConstants;
+export declare const Constants: IConstants;

package/build-ngc/core/constants.js

@@ -0,0 +1,20 @@
+import { UnavailabilityError } from 'expo-modules-core';
+import { expoConstants } from './native-module';
+const NATIVE_MODULE_NAME = 'expo-constants';
+/** The native fields of the `ExponentConstants` module, without the Expo manifest family */
+export function createConstants(native) {
+    const { name, appOwnership, manifest, manifest2, expoConfig, expoGoConfig, easConfig, getWebViewUserAgentAsync, ...nativeFields } = native;
+    return {
+        ...nativeFields,
+        // Ensure this is null in bare workflow
+        appOwnership: appOwnership ?? null,
+        async getWebViewUserAgentAsync() {
+            if (!getWebViewUserAgentAsync) {
+                throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getWebViewUserAgentAsync');
+            }
+            return getWebViewUserAgentAsync();
+        },
+    };
+}
+export const Constants = createConstants(expoConstants);
+//# sourceMappingURL=constants.js.map

package/build-ngc/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAE5C,4FAA4F;AAC5F,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,MAAM,EACJ,IAAI,EACJ,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,UAAU,EACV,YAAY,EACZ,SAAS,EACT,wBAAwB,EACxB,GAAG,YAAY,EAChB,GAAG,MAAM,CAAC;IAEX,OAAO;QACL,GAAG,YAAY;QACf,uCAAuC;QACvC,YAAY,EAAE,YAAY,IAAI,IAAI;QAClC,KAAK,CAAC,wBAAwB;YAC5B,IAAI,CAAC,wBAAwB,EAAE,CAAC;gBAC9B,MAAM,IAAI,mBAAmB,CAC3B,kBAAkB,EAClB,0BAA0B,CAC3B,CAAC;YACJ,CAAC;YACD,OAAO,wBAAwB,EAAE,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAe,eAAe,CAAC,aAAa,CAAC,CAAC"}

package/build-ngc/core/index.d.ts

@@ -0,0 +1,2 @@
+export { Constants, createConstants } from './constants';
+export { AppOwnership, ExecutionEnvironment, UserInterfaceIdiom, type IAndroidPlatformConstants, type IConstants, type IIosPlatformConstants, type IPlatformConstants, } from './types';

package/build-ngc/core/index.js

@@ -0,0 +1,3 @@
+export { Constants, createConstants } from './constants';
+export { AppOwnership, ExecutionEnvironment, UserInterfaceIdiom, } from './types';
+//# sourceMappingURL=index.js.map

package/build-ngc/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,GAKnB,MAAM,SAAS,CAAC"}

package/build-ngc/core/native-module.d.ts

@@ -0,0 +1,12 @@
+import type { AppOwnership, IConstants } from './types';
+export type INativeConstantsModule = Omit<IConstants, 'appOwnership' | 'getWebViewUserAgentAsync'> & {
+    name?: string;
+    appOwnership?: AppOwnership | null;
+    manifest?: unknown;
+    manifest2?: unknown;
+    expoConfig?: unknown;
+    expoGoConfig?: unknown;
+    easConfig?: unknown;
+    getWebViewUserAgentAsync?: () => Promise<string | null>;
+};
+export declare const expoConstants: INativeConstantsModule;

package/build-ngc/core/native-module.js

@@ -0,0 +1,4 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPONENT_CONSTANTS_MODULE_NAME = 'ExponentConstants';
+export const expoConstants = requireNativeModule(EXPONENT_CONSTANTS_MODULE_NAME);
+//# sourceMappingURL=native-module.js.map

package/build-ngc/core/native-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,8BAA8B,GAAG,mBAAmB,CAAC;AAkB3D,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAC9C,8BAA8B,CAC/B,CAAC"}

package/build-ngc/core/types.d.ts

@@ -0,0 +1,52 @@
+export declare enum AppOwnership {
+    Expo = "expo"
+}
+export declare enum ExecutionEnvironment {
+    Bare = "bare",
+    Standalone = "standalone",
+    StoreClient = "storeClient"
+}
+export declare enum UserInterfaceIdiom {
+    Handset = "handset",
+    Tablet = "tablet",
+    Desktop = "desktop",
+    TV = "tv",
+    Unsupported = "unsupported"
+}
+/** @platform ios */
+export type IIosPlatformConstants = {
+    buildNumber: string | null;
+    platform: string;
+    model: string | null;
+    userInterfaceIdiom: UserInterfaceIdiom;
+    systemVersion: string;
+};
+/** @platform android */
+export type IAndroidPlatformConstants = {
+    versionCode: number;
+};
+export type IPlatformConstants = {
+    ios?: IIosPlatformConstants;
+    android?: IAndroidPlatformConstants;
+};
+export type IConstants = {
+    appOwnership: AppOwnership | null;
+    debugMode: boolean;
+    deviceName?: string;
+    deviceYearClass: number | null;
+    executionEnvironment: ExecutionEnvironment;
+    experienceUrl: string;
+    expoRuntimeVersion: string | null;
+    expoVersion: string | null;
+    isDetached?: boolean;
+    intentUri?: string;
+    isHeadless: boolean;
+    linkingUri: string;
+    sessionId: string;
+    statusBarHeight: number;
+    systemFonts: string[];
+    systemVersion?: number;
+    supportedExpoSdks?: string[];
+    platform?: IPlatformConstants;
+    getWebViewUserAgentAsync: () => Promise<string | null>;
+};

package/build-ngc/core/types.js

@@ -0,0 +1,19 @@
+export var AppOwnership;
+(function (AppOwnership) {
+    AppOwnership["Expo"] = "expo";
+})(AppOwnership || (AppOwnership = {}));
+export var ExecutionEnvironment;
+(function (ExecutionEnvironment) {
+    ExecutionEnvironment["Bare"] = "bare";
+    ExecutionEnvironment["Standalone"] = "standalone";
+    ExecutionEnvironment["StoreClient"] = "storeClient";
+})(ExecutionEnvironment || (ExecutionEnvironment = {}));
+export var UserInterfaceIdiom;
+(function (UserInterfaceIdiom) {
+    UserInterfaceIdiom["Handset"] = "handset";
+    UserInterfaceIdiom["Tablet"] = "tablet";
+    UserInterfaceIdiom["Desktop"] = "desktop";
+    UserInterfaceIdiom["TV"] = "tv";
+    UserInterfaceIdiom["Unsupported"] = "unsupported";
+})(UserInterfaceIdiom || (UserInterfaceIdiom = {}));
+//# sourceMappingURL=types.js.map

package/build-ngc/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,YAEX;AAFD,WAAY,YAAY;IACtB,6BAAa,CAAA;AACf,CAAC,EAFW,YAAY,KAAZ,YAAY,QAEvB;AAED,MAAM,CAAN,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC9B,qCAAa,CAAA;IACb,iDAAyB,CAAA;IACzB,mDAA2B,CAAA;AAC7B,CAAC,EAJW,oBAAoB,KAApB,oBAAoB,QAI/B;AAED,MAAM,CAAN,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC5B,yCAAmB,CAAA;IACnB,uCAAiB,CAAA;IACjB,yCAAmB,CAAA;IACnB,+BAAS,CAAA;IACT,iDAA2B,CAAA;AAC7B,CAAC,EANW,kBAAkB,KAAlB,kBAAkB,QAM7B"}

package/native-link.json

@@ -0,0 +1,19 @@
+{
+  "android": {
+    "gradleProjectName": "expo-constants",
+    "modules": [
+      {
+        "importPath": "expo.modules.constants.ConstantsModule",
+        "className": "ConstantsModule",
+        "nativeName": "ExponentConstants"
+      }
+    ],
+    "services": [
+      {
+        "importPath": "expo.modules.constants.ConstantsService",
+        "className": "ConstantsService",
+        "gradleProjectName": "expo-constants"
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,150 @@
+{
+  "name": "@symbiote-native/constants",
+  "version": "3.0.2",
+  "description": "expo-constants wrapped for SymbioteNative, trimmed to its native fields — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Session ID, status bar height, system fonts, linking URI, execution environment, device name and year class, the Android/iOS platform block and the WebView user agent. The Expo manifest (`expoConfig`, `manifest`, `easConfig`) is not ported.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/constants"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/constants#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "keywords": [
+    "react-native",
+    "symbiote-native",
+    "expo-constants",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "angular",
+    "session-id",
+    "status-bar-height"
+  ],
+  "type": "module",
+  "main": "./build/core/index.js",
+  "module": "./build/core/index.js",
+  "types": "./build/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./vue": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./react": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./svelte": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./solid": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./angular": {
+      "types": "./build-ngc/angular/index.d.ts",
+      "react-native": "./build-ngc/angular/index.js",
+      "default": "./src/angular/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "build",
+    "build-ngc",
+    "native-link.json",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "expo-constants": "57.0.19",
+    "expo-modules-core": "57.0.20"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=20",
+    "@vue/runtime-core": "^3.5.13",
+    "react": ">=19.0.0",
+    "react-native": ">=0.86",
+    "solid-js": ">=1.9.0",
+    "svelte": ">=5.56.0",
+    "vue": ">=3.5.0",
+    "@symbiote-native/angular": "^3.1.3",
+    "@symbiote-native/engine": "^1.4.0",
+    "@symbiote-native/react": "^3.1.0",
+    "@symbiote-native/svelte": "^3.0.5",
+    "@symbiote-native/solid": "^3.0.5",
+    "@symbiote-native/vue": "^3.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@symbiote-native/angular": {
+      "optional": true
+    },
+    "@symbiote-native/react": {
+      "optional": true
+    },
+    "@symbiote-native/solid": {
+      "optional": true
+    },
+    "@symbiote-native/svelte": {
+      "optional": true
+    },
+    "@symbiote-native/vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/compiler": "~22.0.8",
+    "@angular/compiler-cli": "~22.0.8",
+    "@angular/core": "~22.0.8",
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@vue/runtime-core": "^3.5.13",
+    "react": "19.2.3",
+    "solid-js": "^1.9.14",
+    "svelte": "^5.56.0",
+    "typescript": "~6.0.0",
+    "@symbiote-native/angular": "3.1.3",
+    "@symbiote-native/engine": "1.4.0",
+    "@symbiote-native/react": "3.1.0",
+    "@symbiote-native/svelte": "3.0.5",
+    "@symbiote-native/vue": "3.1.0",
+    "@symbiote-native/test-utils": "0.4.5",
+    "@symbiote-native/solid": "3.0.5"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "clean": "rm -rf build-ngc",
+    "ng:build": "pnpm run clean && ngc -p tsconfig.angular.json",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  }
+}

package/src/angular/index.ts

@@ -0,0 +1,3 @@
+// @symbiote-native/constants/angular: the Angular entry over the framework-agnostic core
+// Nothing here is per-instance or event-driven, so there is no service to wrap, plain re-export
+export * from '../core';

package/src/core/constants.ts

@@ -0,0 +1,38 @@
+import { UnavailabilityError } from 'expo-modules-core';
+import { expoConstants } from './native-module';
+import type { INativeConstantsModule } from './native-module';
+import type { IConstants } from './types';
+
+const NATIVE_MODULE_NAME = 'expo-constants';
+
+/** The native fields of the `ExponentConstants` module, without the Expo manifest family */
+export function createConstants(native: INativeConstantsModule): IConstants {
+  const {
+    name,
+    appOwnership,
+    manifest,
+    manifest2,
+    expoConfig,
+    expoGoConfig,
+    easConfig,
+    getWebViewUserAgentAsync,
+    ...nativeFields
+  } = native;
+
+  return {
+    ...nativeFields,
+    // Ensure this is null in bare workflow
+    appOwnership: appOwnership ?? null,
+    async getWebViewUserAgentAsync() {
+      if (!getWebViewUserAgentAsync) {
+        throw new UnavailabilityError(
+          NATIVE_MODULE_NAME,
+          'getWebViewUserAgentAsync',
+        );
+      }
+      return getWebViewUserAgentAsync();
+    },
+  };
+}
+
+export const Constants: IConstants = createConstants(expoConstants);

package/src/core/index.ts

@@ -0,0 +1,10 @@
+export { Constants, createConstants } from './constants';
+export {
+  AppOwnership,
+  ExecutionEnvironment,
+  UserInterfaceIdiom,
+  type IAndroidPlatformConstants,
+  type IConstants,
+  type IIosPlatformConstants,
+  type IPlatformConstants,
+} from './types';

package/src/core/native-module.ts

@@ -0,0 +1,24 @@
+import { requireNativeModule } from 'expo-modules-core';
+import type { AppOwnership, IConstants } from './types';
+
+const EXPONENT_CONSTANTS_MODULE_NAME = 'ExponentConstants';
+
+// The module object itself carries the constants as properties. Its manifest family is typed
+// `unknown` because it is read only to be dropped
+export type INativeConstantsModule = Omit<
+  IConstants,
+  'appOwnership' | 'getWebViewUserAgentAsync'
+> & {
+  name?: string;
+  appOwnership?: AppOwnership | null;
+  manifest?: unknown;
+  manifest2?: unknown;
+  expoConfig?: unknown;
+  expoGoConfig?: unknown;
+  easConfig?: unknown;
+  getWebViewUserAgentAsync?: () => Promise<string | null>;
+};
+
+export const expoConstants = requireNativeModule<INativeConstantsModule>(
+  EXPONENT_CONSTANTS_MODULE_NAME,
+);

package/src/core/types.ts

@@ -0,0 +1,60 @@
+export enum AppOwnership {
+  Expo = 'expo',
+}
+
+export enum ExecutionEnvironment {
+  Bare = 'bare',
+  Standalone = 'standalone',
+  StoreClient = 'storeClient',
+}
+
+export enum UserInterfaceIdiom {
+  Handset = 'handset',
+  Tablet = 'tablet',
+  Desktop = 'desktop',
+  TV = 'tv',
+  Unsupported = 'unsupported',
+}
+
+/** @platform ios */
+export type IIosPlatformConstants = {
+  buildNumber: string | null;
+  platform: string;
+  model: string | null;
+  userInterfaceIdiom: UserInterfaceIdiom;
+  systemVersion: string;
+};
+
+/** @platform android */
+export type IAndroidPlatformConstants = {
+  versionCode: number;
+};
+
+export type IPlatformConstants = {
+  ios?: IIosPlatformConstants;
+  android?: IAndroidPlatformConstants;
+};
+
+// The native fields of upstream's `Constants`. The manifest family (`manifest`, `manifest2`,
+// `expoConfig`, `expoGoConfig`, `easConfig`) is not ported, this project has no Expo manifest
+export type IConstants = {
+  appOwnership: AppOwnership | null;
+  debugMode: boolean;
+  deviceName?: string;
+  deviceYearClass: number | null;
+  executionEnvironment: ExecutionEnvironment;
+  experienceUrl: string;
+  expoRuntimeVersion: string | null;
+  expoVersion: string | null;
+  isDetached?: boolean;
+  intentUri?: string;
+  isHeadless: boolean;
+  linkingUri: string;
+  sessionId: string;
+  statusBarHeight: number;
+  systemFonts: string[];
+  systemVersion?: number;
+  supportedExpoSdks?: string[];
+  platform?: IPlatformConstants;
+  getWebViewUserAgentAsync: () => Promise<string | null>;
+};