@symbiote-native/contacts 0.1.0

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

@@ -0,0 +1,64 @@
+import { Platform, requireNativeModule } from 'expo-modules-core';
+const EXPO_CONTACTS_NEXT_MODULE_NAME = 'ExpoContactsNext';
+export const ON_CONTACTS_CHANGE_EVENT_NAME = 'contactsDidChange';
+export class FallbackGroup {
+    id;
+    constructor(id) {
+        this.id = id;
+    }
+    getName() {
+        throw new Error('Not implemented');
+    }
+    setName(_name) {
+        throw new Error('Not implemented');
+    }
+    addContact(_contact) {
+        throw new Error('Not implemented');
+    }
+    removeContact(_contact) {
+        throw new Error('Not implemented');
+    }
+    getContacts() {
+        throw new Error('Not implemented');
+    }
+    delete() {
+        throw new Error('Not implemented');
+    }
+    static create(_name, _containerId) {
+        throw new Error('Not implemented');
+    }
+    static getAll(_containerId) {
+        throw new Error('Not implemented');
+    }
+}
+export class FallbackContainer {
+    id;
+    constructor(id) {
+        this.id = id;
+    }
+    getName() {
+        throw new Error('Not implemented');
+    }
+    getType() {
+        throw new Error('Not implemented');
+    }
+    getGroups() {
+        throw new Error('Not implemented');
+    }
+    getContacts() {
+        throw new Error('Not implemented');
+    }
+    static getAll() {
+        throw new Error('Not implemented');
+    }
+    static getDefault() {
+        throw new Error('Not implemented');
+    }
+}
+export const expoContactsNext = requireNativeModule(EXPO_CONTACTS_NEXT_MODULE_NAME);
+// iOS registers the class as `ContactNext` (distinct from the deprecated legacy `Contact` JS
+// class); Android registers it directly as `Contact`. Alias so both platforms expose `.Contact`.
+if (Platform.OS === 'ios' && expoContactsNext.ContactNext) {
+    expoContactsNext.Contact = expoContactsNext.ContactNext;
+}
+//# 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,QAAQ,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAiClE,MAAM,8BAA8B,GAAG,kBAAkB,CAAC;AAC1D,MAAM,CAAC,MAAM,6BAA6B,GAAG,mBAAmB,CAAC;AA8KjE,MAAM,OAAO,aAAa;IACI;IAA5B,YAA4B,EAAU;QAAV,OAAE,GAAF,EAAE,CAAQ;IAAG,CAAC;IAC1C,OAAO;QACL,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,KAAa;QACnB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,UAAU,CAAC,QAAuB;QAChC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,aAAa,CAAC,QAAuB;QACnC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,WAAW;QACT,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,MAAM;QACJ,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,KAAa,EAAE,YAAqB;QAChD,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,YAAqB;QACjC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,iBAAiB;IACA;IAA5B,YAA4B,EAAU;QAAV,OAAE,GAAF,EAAE,CAAQ;IAAG,CAAC;IAC1C,OAAO;QACL,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,OAAO;QACL,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,SAAS;QACP,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,WAAW;QACT,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,CAAC,MAAM;QACX,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,CAAC,UAAU;QACf,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;CACF;AAgBD,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CACjD,8BAA8B,CAC/B,CAAC;AAEF,6FAA6F;AAC7F,iGAAiG;AACjG,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,IAAI,gBAAgB,CAAC,WAAW,EAAE,CAAC;IAC1D,gBAAgB,CAAC,OAAO,GAAG,gBAAgB,CAAC,WAAW,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ContactsPermissionResponse } from './types';
+export declare function getPermissionsAsync(): Promise<ContactsPermissionResponse>;
+export declare function requestPermissionsAsync(): Promise<ContactsPermissionResponse>;

package/build-ngc/core/permissions.js

@@ -0,0 +1,8 @@
+import { expoContactsNext } from './native-module';
+export async function getPermissionsAsync() {
+    return expoContactsNext.getPermissionsAsync();
+}
+export async function requestPermissionsAsync() {
+    return expoContactsNext.requestPermissionsAsync();
+}
+//# sourceMappingURL=permissions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/core/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,OAAO,gBAAgB,CAAC,mBAAmB,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,OAAO,gBAAgB,CAAC,uBAAuB,EAAE,CAAC;AACpD,CAAC"}

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

@@ -0,0 +1,244 @@
+import type { PermissionResponse } from 'expo-modules-core';
+import type { ContactField, ContactsSortOrder, NonGregorianCalendar } from './enums';
+export type ContactsPermissionResponse = PermissionResponse & {
+    accessPrivileges?: 'all' | 'limited' | 'none';
+};
+export type ContactQueryOptions = {
+    limit?: number;
+    offset?: number;
+    sortOrder?: ContactsSortOrder;
+    name?: string;
+    /** @platform ios */
+    rawContacts?: boolean;
+};
+export type FormOptions = {
+    displayedPropertyKeys?: ContactField[];
+    message?: string;
+    alternateName?: string;
+    allowsEditing?: boolean;
+    allowsActions?: boolean;
+    shouldShowLinkedContacts?: boolean;
+    isNew?: boolean;
+    cancelButtonTitle?: string;
+    showsCancelButton?: boolean;
+    preventAnimation?: boolean;
+    groupId?: string;
+};
+export type CreateFormOptions = {
+    cancelButtonTitle?: string;
+    showsCancelButton?: boolean;
+    preventAnimation?: boolean;
+};
+export type NewEmail = {
+    label?: string;
+    address?: string;
+};
+export type ExistingEmail = NewEmail & {
+    id: string;
+};
+export type NewPhone = {
+    label?: string;
+    number?: string;
+};
+export type ExistingPhone = NewPhone & {
+    id: string;
+};
+export type NewDate = {
+    label?: string;
+    date?: ContactDate;
+};
+export type ExistingDate = NewDate & {
+    id: string;
+};
+export type NewExtraName = {
+    label?: string;
+    name?: string;
+};
+export type ExistingExtraName = NewExtraName & {
+    id: string;
+};
+export type NewAddress = {
+    label?: string;
+    street?: string;
+    city?: string;
+    state?: string;
+    postcode?: string;
+    region?: string;
+    country?: string;
+};
+export type ExistingAddress = NewAddress & {
+    id: string;
+};
+export type NewRelation = {
+    label?: string;
+    name?: string;
+};
+export type ExistingRelation = NewRelation & {
+    id: string;
+};
+export type NewUrlAddress = {
+    label?: string;
+    url?: string;
+};
+export type ExistingUrlAddress = NewUrlAddress & {
+    id: string;
+};
+export type NewImAddress = {
+    label?: string;
+    username?: string;
+    service?: string;
+};
+export type ExistingImAddress = NewImAddress & {
+    id: string;
+};
+export type NewSocialProfile = {
+    label?: string;
+    username?: string;
+    service?: string;
+    url?: string;
+    userId?: string;
+};
+export type ExistingSocialProfile = NewSocialProfile & {
+    id: string;
+};
+export type ContactDate = {
+    year?: number;
+    month: number;
+    day: number;
+};
+/** @platform ios */
+export type NonGregorianBirthday = {
+    year?: number;
+    month: number;
+    day: number;
+    calendar: NonGregorianCalendar;
+};
+export type ContactPatch = {
+    isFavourite?: boolean | null;
+    givenName?: string | null;
+    middleName?: string | null;
+    familyName?: string | null;
+    nickname?: string | null;
+    maidenName?: string | null;
+    prefix?: string | null;
+    suffix?: string | null;
+    phoneticGivenName?: string | null;
+    phoneticMiddleName?: string | null;
+    phoneticFamilyName?: string | null;
+    company?: string | null;
+    department?: string | null;
+    jobTitle?: string | null;
+    phoneticCompanyName?: string | null;
+    note?: string | null;
+    image?: string | null;
+    birthday?: ContactDate | null;
+    nonGregorianBirthday?: NonGregorianBirthday | null;
+    emails?: (ExistingEmail | NewEmail)[];
+    phones?: (ExistingPhone | NewPhone)[];
+    dates?: (ExistingDate | NewDate)[];
+    extraNames?: (ExistingExtraName | NewExtraName)[];
+    addresses?: (ExistingAddress | NewAddress)[];
+    relations?: (ExistingRelation | NewRelation)[];
+    urlAddresses?: (ExistingUrlAddress | NewUrlAddress)[];
+    socialProfiles?: (ExistingSocialProfile | NewSocialProfile)[];
+    imAddresses?: (ExistingImAddress | NewImAddress)[];
+};
+export type CreateContactRecord = {
+    isFavourite?: boolean;
+    givenName?: string;
+    middleName?: string;
+    familyName?: string;
+    maidenName?: string;
+    nickname?: string;
+    prefix?: string;
+    suffix?: string;
+    phoneticGivenName?: string;
+    phoneticMiddleName?: string;
+    phoneticFamilyName?: string;
+    company?: string;
+    department?: string;
+    jobTitle?: string;
+    phoneticCompanyName?: string;
+    note?: string;
+    image?: string;
+    birthday?: ContactDate;
+    nonGregorianBirthday?: NonGregorianBirthday;
+    emails?: NewEmail[];
+    dates?: NewDate[];
+    phones?: NewPhone[];
+    addresses?: NewAddress[];
+    relations?: NewRelation[];
+    urlAddresses?: NewUrlAddress[];
+    imAddresses?: NewImAddress[];
+    socialProfiles?: NewSocialProfile[];
+    extraNames?: NewExtraName[];
+};
+export type ContactDetails = {
+    isFavourite: boolean;
+    fullName: string | null;
+    givenName: string | null;
+    middleName: string | null;
+    familyName: string | null;
+    maidenName?: string | null;
+    nickname?: string | null;
+    prefix: string | null;
+    suffix: string | null;
+    phoneticGivenName: string | null;
+    phoneticMiddleName: string | null;
+    phoneticFamilyName: string | null;
+    company: string | null;
+    department: string | null;
+    jobTitle?: string;
+    phoneticCompanyName?: string;
+    note: string | null;
+    image: string | null;
+    thumbnail: string | null;
+    birthday?: ContactDate | null;
+    nonGregorianBirthday?: NonGregorianBirthday | null;
+    emails: ExistingEmail[];
+    dates: ExistingDate[];
+    phones: ExistingPhone[];
+    extraNames: ExistingExtraName[];
+    addresses: ExistingAddress[];
+    relations: ExistingRelation[];
+    urlAddresses: ExistingUrlAddress[];
+    socialProfiles: ExistingSocialProfile[];
+    imAddresses: ExistingImAddress[];
+};
+export type ContactFieldKey = {
+    [ContactField.IS_FAVOURITE]: 'isFavourite';
+    [ContactField.FULL_NAME]: 'fullName';
+    [ContactField.GIVEN_NAME]: 'givenName';
+    [ContactField.MIDDLE_NAME]: 'middleName';
+    [ContactField.FAMILY_NAME]: 'familyName';
+    [ContactField.MAIDEN_NAME]: 'maidenName';
+    [ContactField.NICKNAME]: 'nickname';
+    [ContactField.PREFIX]: 'prefix';
+    [ContactField.SUFFIX]: 'suffix';
+    [ContactField.PHONETIC_GIVEN_NAME]: 'phoneticGivenName';
+    [ContactField.PHONETIC_MIDDLE_NAME]: 'phoneticMiddleName';
+    [ContactField.PHONETIC_FAMILY_NAME]: 'phoneticFamilyName';
+    [ContactField.COMPANY]: 'company';
+    [ContactField.PHONETIC_COMPANY_NAME]: 'phoneticCompanyName';
+    [ContactField.DEPARTMENT]: 'department';
+    [ContactField.JOB_TITLE]: 'jobTitle';
+    [ContactField.NOTE]: 'note';
+    [ContactField.IMAGE]: 'image';
+    [ContactField.THUMBNAIL]: 'thumbnail';
+    [ContactField.BIRTHDAY]: 'birthday';
+    [ContactField.NON_GREGORIAN_BIRTHDAY]: 'nonGregorianBirthday';
+    [ContactField.EMAILS]: 'emails';
+    [ContactField.PHONES]: 'phones';
+    [ContactField.ADDRESSES]: 'addresses';
+    [ContactField.DATES]: 'dates';
+    [ContactField.EXTRA_NAMES]: 'extraNames';
+    [ContactField.RELATIONS]: 'relations';
+    [ContactField.URL_ADDRESSES]: 'urlAddresses';
+    [ContactField.SOCIAL_PROFILES]: 'socialProfiles';
+    [ContactField.IM_ADDRESSES]: 'imAddresses';
+};
+export type PartialContactDetails<T extends readonly ContactField[]> = {
+    id: string;
+} & {
+    [K in T[number]]: ContactDetails[K];
+};

package/build-ngc/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# 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":""}

package/native-link.json

@@ -0,0 +1,26 @@
+{
+  "android": {
+    "gradleProjectName": "expo-contacts",
+    "modules": [
+      {
+        "importPath": "expo.modules.contacts.ContactsModule",
+        "className": "ContactsModule",
+        "nativeName": "ExpoContacts"
+      },
+      {
+        "importPath": "expo.modules.contacts.next.ContactsNextModule",
+        "className": "ContactsNextModule",
+        "nativeName": "ExpoContactsNext"
+      }
+    ],
+    "manifestPermissions": [
+      "android.permission.READ_CONTACTS",
+      "android.permission.WRITE_CONTACTS"
+    ]
+  },
+  "ios": {
+    "infoPlistKeys": {
+      "NSContactsUsageDescription": "This app uses your contacts to read and manage your address book."
+    }
+  }
+}

package/package.json

@@ -0,0 +1,152 @@
+{
+  "name": "@symbiote-native/contacts",
+  "version": "0.1.0",
+  "description": "expo-contacts wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Both surfaces: the modern SharedObject-class Contact/Group/Container API (default entry) and the legacy function-based API (/legacy subpath).",
+  "license": "MIT",
+  "keywords": [
+    "react-native",
+    "symbiote-native",
+    "expo-contacts",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "angular",
+    "contacts",
+    "address-book"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/contacts"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/contacts#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "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/vue/index.d.ts",
+      "default": "./build/vue/index.js"
+    },
+    "./react": {
+      "types": "./build/react/index.d.ts",
+      "default": "./build/react/index.js"
+    },
+    "./svelte": "./src/svelte/index.ts",
+    "./solid": {
+      "types": "./build/solid/index.d.ts",
+      "default": "./build/solid/index.js"
+    },
+    "./angular": {
+      "types": "./build-ngc/angular/index.d.ts",
+      "react-native": "./build-ngc/angular/index.js",
+      "default": "./src/angular/index.ts"
+    },
+    "./legacy": {
+      "types": "./build/legacy/index.d.ts",
+      "default": "./build/legacy/index.js"
+    }
+  },
+  "files": [
+    "src",
+    "build",
+    "build-ngc",
+    "native-link.json",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "expo-contacts": "57.0.6",
+    "expo-modules-core": "57.0.20",
+    "@symbiote-native/components": "3.1.3"
+  },
+  "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/solid": "^3.0.5",
+    "@symbiote-native/react": "^3.1.0",
+    "@symbiote-native/svelte": "^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",
+    "typescript": "~6.0.0",
+    "svelte": "^5.56.0",
+    "@symbiote-native/angular": "3.1.3",
+    "@symbiote-native/solid": "3.0.5",
+    "@symbiote-native/engine": "1.4.0",
+    "@symbiote-native/test-utils": "0.4.5",
+    "@symbiote-native/react": "3.1.0",
+    "@symbiote-native/svelte": "3.0.5",
+    "@symbiote-native/vue": "3.1.0"
+  },
+  "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/contact-access-button/index.ts

@@ -0,0 +1,45 @@
+import { ChangeDetectionStrategy, Component, Input } from '@angular/core';
+import { DescriptorOutlet, NativeViewBase } from '@symbiote-native/angular';
+import type { IDescriptor } from '@symbiote-native/components';
+import {
+  isContactAccessButtonAvailable,
+  renderContactAccessButton,
+} from '../../core/contact-access-button';
+import type { IContactAccessButtonProps } from '../../core/contact-access-button';
+
+/** Angular twin of `expo-contacts`' `ContactAccessButton`, iOS 18+ only, nothing elsewhere */
+@Component({
+  selector: 'ContactAccessButton',
+  standalone: true,
+  imports: [DescriptorOutlet],
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  template: `@if (descriptor; as node) {
+    <symbiote-descriptor-outlet [node]="node" />
+  }`,
+})
+export class ContactAccessButton extends NativeViewBase {
+  /** True only on iOS 18.0 and newer */
+  static readonly isAvailable = isContactAccessButtonAvailable;
+
+  @Input() query?: string;
+  @Input() caption?: IContactAccessButtonProps['caption'];
+  @Input() ignoredEmails?: string[];
+  @Input() ignoredPhoneNumbers?: string[];
+  @Input() tintColor?: IContactAccessButtonProps['tintColor'];
+  @Input() backgroundColor?: IContactAccessButtonProps['backgroundColor'];
+  @Input() textColor?: IContactAccessButtonProps['textColor'];
+
+  protected override readonly propNames = [
+    'query',
+    'caption',
+    'ignoredEmails',
+    'ignoredPhoneNumbers',
+    'tintColor',
+    'backgroundColor',
+    'textColor',
+  ] as const satisfies readonly (keyof ContactAccessButton)[];
+
+  protected override renderView(props: object): IDescriptor | null {
+    return renderContactAccessButton(props);
+  }
+}

package/src/angular/index.ts

@@ -0,0 +1,3 @@
+// No per-instance state or event stream to wrap in an injectable service - plain re-export.
+export * from '../core';
+export { ContactAccessButton } from './contact-access-button';

package/src/core/contact-access-button.ts

@@ -0,0 +1,83 @@
+import {
+  Platform,
+  requireNativeViewManager,
+  requireOptionalNativeModule,
+} from 'expo-modules-core';
+import { el } from '@symbiote-native/components';
+import type {
+  IAccessibilityProps,
+  IAriaProps,
+  IDescriptor,
+  IResponderProps,
+} from '@symbiote-native/components';
+import {
+  expoViewManagerName,
+  tryRegisterNativeView,
+} from '@symbiote-native/engine';
+import type {
+  IColorValue,
+  IStyleProp,
+  ISymbioteEvent,
+  IViewStyle,
+} from '@symbiote-native/engine';
+
+export const CONTACT_ACCESS_BUTTON_MODULE_NAME = 'ExpoContactAccessButton';
+
+export type IContactAccessButtonCaption = 'default' | 'email' | 'phone';
+
+// Every field is iOS 18+ only, the button renders nothing anywhere else
+export type IContactAccessButtonProps = IAccessibilityProps &
+  IAriaProps &
+  IResponderProps & {
+    /** Matched against contacts not yet exposed to the app, typically from a search field */
+    query?: string;
+    /** Caption under the contact name when the query has one match, nothing by default */
+    caption?: IContactAccessButtonCaption;
+    /** Contacts matching `query` that also match one of these emails are left out */
+    ignoredEmails?: string[];
+    /** Contacts matching `query` that also match one of these phone numbers are left out */
+    ignoredPhoneNumbers?: string[];
+    /** Tint of the button and of the modal shown when there is more than one match */
+    tintColor?: IColorValue;
+    /** Button background, keep it opaque to satisfy the platform legibility rules */
+    backgroundColor?: IColorValue;
+    /** Button title color, a dimmed version of it is used for the caption */
+    textColor?: IColorValue;
+    style?: IStyleProp<IViewStyle>;
+    testID?: string;
+    nativeID?: string;
+    onLayout?: (event: ISymbioteEvent) => void;
+  };
+
+type IContactAccessButtonModule = { isAvailable: boolean };
+
+export function contactAccessButtonViewName(): string {
+  return expoViewManagerName(CONTACT_ACCESS_BUTTON_MODULE_NAME);
+}
+
+/** True only on iOS 18.0 and newer, where the native module reports the button as available */
+export function isContactAccessButtonAvailable(): boolean {
+  return (
+    Platform.OS === 'ios' &&
+    (requireOptionalNativeModule<IContactAccessButtonModule>(
+      CONTACT_ACCESS_BUTTON_MODULE_NAME,
+    )?.isAvailable ??
+      false)
+  );
+}
+
+// Registers the view config in React Native's registry, which the engine derives the view's events
+// and prop processors from. Called at render, not at import: a registration that only a barrel's
+// load-time side effect performs is dropped by Metro's `inlineRequires` in release
+export function ensureContactAccessButtonRegistered(): boolean {
+  if (Platform.OS !== 'ios') return false;
+  return tryRegisterNativeView(() =>
+    requireNativeViewManager(CONTACT_ACCESS_BUTTON_MODULE_NAME),
+  );
+}
+
+// `object`, not the props type: Vue and Angular hand over an untyped attribute bag
+export function renderContactAccessButton(props: object): IDescriptor | null {
+  if (!ensureContactAccessButtonRegistered()) return null;
+  return el(contactAccessButtonViewName(), { ...props });
+}

package/src/core/contact.ts

@@ -0,0 +1,3 @@
+import { expoContactsNext } from './native-module';
+
+export class Contact extends expoContactsNext.Contact {}

package/src/core/container.ts

@@ -0,0 +1,5 @@
+import { expoContactsNext, FallbackContainer } from './native-module';
+
+/** @platform ios - Android has no Container concept in expo-contacts. */
+export class Container extends (expoContactsNext.Container ??
+  FallbackContainer) {}