expo-app-intents 0.2.0 → 0.3.0

package/.npmignore

@@ -20,3 +20,8 @@ __rsc_tests__
 
 CLAUDE.md
 CONTRIBUTING.md
+
+# Exclude native build output (pnpm pack ignores nested .gitignore files)
+.cxx/
+.gradle/
+/android/build/

package/CHANGELOG.md

@@ -10,6 +10,16 @@
 
 ### 💡 Others
 
+## 0.3.0 — 2026-09-14
+
+### 🎉 New features
+
+- [iOS] Add `AppEntityView`, a UIKit wrapper for associating React Native content with an App Entity. ([#49663](https://github.com/expo/expo/pull/49663) by [@behenate](https://github.com/behenate))
+
+### 🐛 Bug fixes
+
+- [iOS] Drop macOS from the podspec platforms to fix `pod install` failing with "Unable to find a specification for `ExpoUI`". ([#50065](https://github.com/expo/expo/pull/50065) by [@gabrieldonadel](https://github.com/gabrieldonadel))
+
 ## 0.2.0 — 2026-09-10
 
 ### 🎉 New features

package/build/AppEntityView.d.ts

@@ -0,0 +1,13 @@
+import type { AppEntityViewProps } from './AppEntityView.types';
+/**
+ * A wrapper that associates its contents with an App Entity so Apple Intelligence and Siri
+ * can understand which entity is visible onscreen. Use it around React Native views; for `@expo/ui`
+ * views, use the [`appEntityIdentifier()`](#appintentsappentityidentifierentity-id) modifier instead.
+ *
+ * > **Note:** The entity association requires iOS 18.4 or later and a project compiled with Xcode 27
+ * > or later. The children still render normally when those requirements are not met, on other
+ * > platforms, or when the native module is unavailable.
+ *
+ * @platform ios
+ */
+export default function AppEntityView({ entity: _entity, entityId: _entityId, ...props }: AppEntityViewProps): import("react/jsx-runtime").JSX.Element;

package/build/AppEntityView.ios.d.ts

@@ -0,0 +1,2 @@
+import type { AppEntityViewProps } from './AppEntityView.types';
+export default function AppEntityView(props: AppEntityViewProps): import("react/jsx-runtime").JSX.Element;

package/build/AppEntityView.ios.js

@@ -0,0 +1,20 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { requireNativeView } from 'expo';
+import { View } from 'react-native';
+import ExpoAppIntents from './ExpoAppIntentsModule';
+const NativeAppEntityView = ExpoAppIntents ? requireNativeView('ExpoAppIntents', 'AppEntityView') : null;
+export default function AppEntityView(props) {
+    if (!NativeAppEntityView) {
+        const { entity: _entity, entityId: _entityId, ...viewProps } = props;
+        return /*#__PURE__*/ _jsx(View, {
+            ...viewProps
+        });
+    }
+    return /*#__PURE__*/ _jsx(NativeAppEntityView, {
+        ...props,
+        collapsable: false
+    });
+}
+
+//# sourceMappingURL=AppEntityView.ios.js.map

package/build/AppEntityView.ios.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["AppEntityView.ios.tsx"],"sourcesContent":[null],"names":["requireNativeView","View","ExpoAppIntents","NativeAppEntityView","AppEntityView","props","entity","_entity","entityId","_entityId","viewProps","collapsable"],"mappings":"AAAA;;AAEA,SAASA,iBAAiB,QAAQ,OAAO;AAEzC,SAASC,IAAI,QAAQ,eAAe;AAGpC,OAAOC,oBAAoB,yBAAyB;AAEpD,MAAMC,sBAAgED,iBAClEF,kBAAsC,kBAAkB,mBACxD;AAEJ,eAAe,SAASI,cAAcC,KAAyB;IAC7D,IAAI,CAACF,qBAAqB;QACxB,MAAM,EAAEG,QAAQC,OAAO,EAAEC,UAAUC,SAAS,EAAE,GAAGC,WAAW,GAAGL;QAC/D,qBAAO,KAACJ;YAAM,GAAGS,SAAS;;IAC5B;IACA,qBAAO,KAACP;QAAqB,GAAGE,KAAK;QAAEM,aAAa;;AACtD"}

package/build/AppEntityView.js

@@ -0,0 +1,20 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { View } from 'react-native';
+/**
+ * A wrapper that associates its contents with an App Entity so Apple Intelligence and Siri
+ * can understand which entity is visible onscreen. Use it around React Native views; for `@expo/ui`
+ * views, use the [`appEntityIdentifier()`](#appintentsappentityidentifierentity-id) modifier instead.
+ *
+ * > **Note:** The entity association requires iOS 18.4 or later and a project compiled with Xcode 27
+ * > or later. The children still render normally when those requirements are not met, on other
+ * > platforms, or when the native module is unavailable.
+ *
+ * @platform ios
+ */ export default function AppEntityView({ entity: _entity, entityId: _entityId, ...props }) {
+    return /*#__PURE__*/ _jsx(View, {
+        ...props
+    });
+}
+
+//# sourceMappingURL=AppEntityView.js.map

package/build/AppEntityView.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["AppEntityView.tsx"],"sourcesContent":[null],"names":["View","AppEntityView","entity","_entity","entityId","_entityId","props"],"mappings":"AAAA;;AAEA,SAASA,IAAI,QAAQ,eAAe;AAIpC;;;;;;;;;;CAUC,GACD,eAAe,SAASC,cAAc,EACpCC,QAAQC,OAAO,EACfC,UAAUC,SAAS,EACnB,GAAGC,OACgB;IACnB,qBAAO,KAACN;QAAM,GAAGM,KAAK;;AACxB"}

package/build/AppEntityView.types.d.ts

@@ -0,0 +1,11 @@
+import type { PropsWithChildren } from 'react';
+import type { ViewProps } from 'react-native';
+/**
+ * Props for a UIKit wrapper that associates its onscreen content with one App Entity.
+ */
+export type AppEntityViewProps = PropsWithChildren<ViewProps & {
+    /** App-specific entity kind registered natively, for example `person` or `dish`. */
+    entity: string;
+    /** Stable entity id from the matching App Intents entity catalog. */
+    entityId: string;
+}>;

package/build/AppEntityView.types.js

@@ -0,0 +1,5 @@
+/**
+ * Props for a UIKit wrapper that associates its onscreen content with one App Entity.
+ */ export { };
+
+//# sourceMappingURL=AppEntityView.types.js.map

package/build/AppEntityView.types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["AppEntityView.types.ts"],"sourcesContent":[null],"names":[],"mappings":"AAGA;;CAEC,GACD,WAOE"}

package/build/ExpoAppIntents.types.d.ts

@@ -1,3 +1,4 @@
+import type { ModifierConfig } from '@expo/ui/swift-ui/modifiers';
 /**
  * A single recorded App Intent invocation.
  *
@@ -50,6 +51,31 @@ export type AppIntentEntity = {
      * Provides alternative spoken names that resolve to this entity.
      */
     synonyms?: string[];
+    /** App-specific string metadata consumed by native AppEntity implementations. */
+    metadata?: Record<string, string>;
+    /**
+     * Whether to keep this entity out of the Spotlight index. It stays resolvable, so Siri can still
+     * offer it as a parameter and open it by identifier — it just is not searchable.
+     *
+     * Only applies to entities registered natively with `registerIndexed`. Defaults to `false`.
+     *
+     * @platform ios
+     */
+    hideInSpotlight?: boolean;
+};
+/**
+ * ExpoUI modifier config that associates a SwiftUI view with an AppEntity identifier.
+ *
+ * Built on `@expo/ui`'s own `ModifierConfig` rather than restating its shape, so that a change to
+ * what the `modifiers` prop accepts is a type error here instead of a value ExpoUI rejects at
+ * runtime.
+ */
+export type AppEntityIdentifierModifier = ModifierConfig & {
+    $type: 'appEntityIdentifier';
+    /** App-specific entity kind registered natively, for example `person` or `dish`. */
+    entity: string;
+    /** Stable entity id from the matching App Intents entity catalog. */
+    id: string;
 };
 export type ExpoAppIntentsModuleEvents = {
     onIntent: (invocation: AppIntentInvocation) => void;

package/build/ExpoAppIntents.types.js

@@ -1,8 +1,5 @@
-/**
- * A single recorded App Intent invocation.
- *
- * The native layer persists each invocation until `removePendingInvocationAsync` removes it.
- * Delivery is at-least-once, so handlers must be idempotent for each `id`.
- */ export { };
+// A type-only import, so nothing from ExpoUI is pulled in at runtime on the platforms where App
+// Intents do not exist.
+export { };
 
 //# sourceMappingURL=ExpoAppIntents.types.js.map

package/build/ExpoAppIntents.types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["ExpoAppIntents.types.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;CAKC,GAsDD,WAEE"}
+{"version":3,"sources":["ExpoAppIntents.types.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA,gGAAgG;AAChG,wBAAwB;AAwFxB,WAEE"}

package/build/ExpoAppIntentsModule.d.ts

@@ -5,6 +5,7 @@ declare class ExpoAppIntentsNativeModule extends NativeModule<ExpoAppIntentsModu
     removePendingInvocationAsync(id: string): Promise<void>;
     clearPendingInvocationsAsync(): Promise<void>;
     setEntityCatalogAsync(kind: string, entities: AppIntentEntity[]): Promise<void>;
+    reindexEntitiesAsync(kind: string | null): Promise<void>;
     getEntityCatalogAsync(kind: string): Promise<AppIntentEntity[]>;
     refreshShortcutsAsync(): Promise<void>;
 }

package/build/ExpoAppIntentsModule.js.map

@@ -1 +1 @@
-{"version":3,"sources":["ExpoAppIntentsModule.ts"],"sourcesContent":[null],"names":["NativeModule","requireOptionalNativeModule"],"mappings":"AAAA,SAASA,YAAY,EAAEC,2BAA2B,QAAQ,oBAAoB;AAiB9E,eAAeA,4BAAwD,kBAAkB"}
+{"version":3,"sources":["ExpoAppIntentsModule.ts"],"sourcesContent":[null],"names":["NativeModule","requireOptionalNativeModule"],"mappings":"AAAA,SAASA,YAAY,EAAEC,2BAA2B,QAAQ,oBAAoB;AAkB9E,eAAeA,4BAAwD,kBAAkB"}

package/build/index.d.ts

@@ -1,6 +1,8 @@
 import { type EventSubscription } from 'expo-modules-core';
-import type { AppIntentEntity, AppIntentInvocation, AppIntentsHandler } from './ExpoAppIntents.types';
+import type { AppEntityIdentifierModifier, AppIntentEntity, AppIntentInvocation, AppIntentsHandler } from './ExpoAppIntents.types';
 export type * from './ExpoAppIntents.types';
+export { default as AppEntityView } from './AppEntityView';
+export type { AppEntityViewProps } from './AppEntityView.types';
 /**
  * Returns whether App Intents are available on this device.
  * Returns `false` on Android and web.
@@ -59,6 +61,11 @@ export declare function clearPendingInvocationsAsync(): Promise<void>;
 /**
  * Replaces the entity catalog of the given kind and asks the system to retrain
  * parameterized shortcut phrases against the new values.
+ * Entities registered natively with
+ * `registerIndexed` also have their Spotlight index rebuilt from the new catalog.
+ *
+ * Publishing a catalog that matches the stored catalog does nothing, so apps can safely call this
+ * function on every start.
  *
  * The native store uses `UserDefaults`, which is best suited to compact catalogs. For large
  * datasets, such as thousands of contacts or songs, apps should store the full data locally and
@@ -70,6 +77,24 @@ export declare function clearPendingInvocationsAsync(): Promise<void>;
  * invalid when another entity in the catalog has the same `id`.
  */
 export declare function setEntityCatalogAsync(kind: string, entities: AppIntentEntity[]): Promise<void>;
+/**
+ * Rebuilds the Spotlight index from the stored entity catalog, whether or not the catalog
+ * changed. `setEntityCatalogAsync` already keeps the index in step, so this is only needed to
+ * recover from an index that no longer matches the catalog: one the system evicted, or one left
+ * stale by an app update that changed how entities describe themselves.
+ *
+ * Pass a `kind` to rebuild one catalog, or omit it to rebuild every kind registered natively with
+ * `registerIndexed`. Kinds with no indexed registration are ignored.
+ *
+ * Rejects when a catalog cannot be read or the index cannot be written, because this is the retry
+ * path and a caller that asked for a rebuild has no other way to learn it did not happen. Every
+ * kind is attempted before the first failure is reported, so one unreadable catalog does not skip
+ * the rest. A kind whose rebuild failed is retried by the next `setEntityCatalogAsync`, even when
+ * the catalog it publishes is unchanged.
+ *
+ * @platform ios
+ */
+export declare function reindexEntitiesAsync(kind?: string): Promise<void>;
 /**
  * Returns the current entity catalog of the given kind.
  * The returned promise is fulfilled with an empty array when the kind was never published or App
@@ -87,3 +112,16 @@ export declare function getEntityCatalogAsync(kind: string): Promise<AppIntentEn
  * shortcuts.
  */
 export declare function refreshShortcutsAsync(): Promise<void>;
+/**
+ * Returns an ExpoUI SwiftUI modifier config that ties a view to an AppEntity identifier.
+ *
+ * The `entity` value must be registered from app-target Swift with
+ * `AppEntityIdentifierRegistry.shared.register(_:as:)` or
+ * `AppEntityIdentifierRegistry.shared.registerIndexed(_:as:)`.
+ *
+ * > **Note:** The entity association requires iOS 18.4 or later and a project compiled with Xcode 27
+ * > or later. Otherwise the view renders normally without it.
+ *
+ * @platform ios
+ */
+export declare function appEntityIdentifier(entity: string, id: string): AppEntityIdentifierModifier;

package/build/index.js

@@ -1,6 +1,7 @@
 import { UnavailabilityError } from 'expo-modules-core';
 import { useEffect, useRef } from 'react';
 import ExpoAppIntents from './ExpoAppIntentsModule';
+export { default as AppEntityView } from './AppEntityView';
 const MAX_SEEN_INVOCATION_IDS = 100;
 /**
  * Returns whether App Intents are available on this device.
@@ -149,6 +150,11 @@ function callAppIntentsHandler(handler, pendingIntents, newIntent) {
 /**
  * Replaces the entity catalog of the given kind and asks the system to retrain
  * parameterized shortcut phrases against the new values.
+ * Entities registered natively with
+ * `registerIndexed` also have their Spotlight index rebuilt from the new catalog.
+ *
+ * Publishing a catalog that matches the stored catalog does nothing, so apps can safely call this
+ * function on every start.
  *
  * The native store uses `UserDefaults`, which is best suited to compact catalogs. For large
  * datasets, such as thousands of contacts or songs, apps should store the full data locally and
@@ -164,6 +170,28 @@ function callAppIntentsHandler(handler, pendingIntents, newIntent) {
     }
     return ExpoAppIntents.setEntityCatalogAsync(kind, entities);
 }
+/**
+ * Rebuilds the Spotlight index from the stored entity catalog, whether or not the catalog
+ * changed. `setEntityCatalogAsync` already keeps the index in step, so this is only needed to
+ * recover from an index that no longer matches the catalog: one the system evicted, or one left
+ * stale by an app update that changed how entities describe themselves.
+ *
+ * Pass a `kind` to rebuild one catalog, or omit it to rebuild every kind registered natively with
+ * `registerIndexed`. Kinds with no indexed registration are ignored.
+ *
+ * Rejects when a catalog cannot be read or the index cannot be written, because this is the retry
+ * path and a caller that asked for a rebuild has no other way to learn it did not happen. Every
+ * kind is attempted before the first failure is reported, so one unreadable catalog does not skip
+ * the rest. A kind whose rebuild failed is retried by the next `setEntityCatalogAsync`, even when
+ * the catalog it publishes is unchanged.
+ *
+ * @platform ios
+ */ export async function reindexEntitiesAsync(kind) {
+    if (!ExpoAppIntents) {
+        return;
+    }
+    return ExpoAppIntents.reindexEntitiesAsync(kind ?? null);
+}
 /**
  * Returns the current entity catalog of the given kind.
  * The returned promise is fulfilled with an empty array when the kind was never published or App
@@ -189,5 +217,23 @@ function callAppIntentsHandler(handler, pendingIntents, newIntent) {
     }
     return ExpoAppIntents.refreshShortcutsAsync();
 }
+/**
+ * Returns an ExpoUI SwiftUI modifier config that ties a view to an AppEntity identifier.
+ *
+ * The `entity` value must be registered from app-target Swift with
+ * `AppEntityIdentifierRegistry.shared.register(_:as:)` or
+ * `AppEntityIdentifierRegistry.shared.registerIndexed(_:as:)`.
+ *
+ * > **Note:** The entity association requires iOS 18.4 or later and a project compiled with Xcode 27
+ * > or later. Otherwise the view renders normally without it.
+ *
+ * @platform ios
+ */ export function appEntityIdentifier(entity, id) {
+    return {
+        $type: 'appEntityIdentifier',
+        entity,
+        id
+    };
+}
 
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["index.ts"],"sourcesContent":[null],"names":["UnavailabilityError","useEffect","useRef","ExpoAppIntents","MAX_SEEN_INVOCATION_IDS","isAvailable","addAppIntentListener","listener","remove","addListener","callAppIntentsHandler","handler","pendingIntents","newIntent","Promise","resolve","then","catch","error","console","warn","useAppIntents","handlerRef","current","isMounted","seenLiveInvocationIds","Set","deliveryQueue","enqueue","deliver","notify","deliverNewIntent","getPendingInvocationsAsync","length","deliverInitialPendingIntents","initialPendingIntents","filter","invocation","has","id","forEach","add","subscription","size","delete","values","next","value","removePendingInvocationAsync","clearPendingInvocationsAsync","setEntityCatalogAsync","kind","entities","getEntityCatalogAsync","refreshShortcutsAsync"],"mappings":"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"}
+{"version":3,"sources":["index.ts"],"sourcesContent":[null],"names":["UnavailabilityError","useEffect","useRef","ExpoAppIntents","default","AppEntityView","MAX_SEEN_INVOCATION_IDS","isAvailable","addAppIntentListener","listener","remove","addListener","callAppIntentsHandler","handler","pendingIntents","newIntent","Promise","resolve","then","catch","error","console","warn","useAppIntents","handlerRef","current","isMounted","seenLiveInvocationIds","Set","deliveryQueue","enqueue","deliver","notify","deliverNewIntent","getPendingInvocationsAsync","length","deliverInitialPendingIntents","initialPendingIntents","filter","invocation","has","id","forEach","add","subscription","size","delete","values","next","value","removePendingInvocationAsync","clearPendingInvocationsAsync","setEntityCatalogAsync","kind","entities","reindexEntitiesAsync","getEntityCatalogAsync","refreshShortcutsAsync","appEntityIdentifier","entity","$type"],"mappings":"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"}

package/cli/build/index.js

@@ -42,20 +42,25 @@ function isInteractive() {
     }
     return true;
 }
+/** Printed before the examples are picked, since it says what picking one gets you. */ function printScaffoldIntro(directory) {
+    console.log(`App Intents are declared in Swift, compiled into your app target. expo-app-intents\n` + `scaffolds example Swift into ${directory}/ and hands invocations to JavaScript.\n`);
+}
 async function runInitCommand(options) {
     const interactive = isInteractive();
     const directory = (0, _init.normalizeDirectory)(options.directory ?? options.dir);
-    const examples = await (0, _init.resolveExamplesAsync)(interactive, options.examples);
+    printScaffoldIntro(directory);
+    const { examples, visualIntelligence } = await (0, _init.resolveExamplesAsync)(interactive, options.examples, options.visualIntelligence ?? false);
     await (0, _init.runInit)({
         projectRoot: process.cwd(),
         directory,
         examples,
+        visualIntelligence,
         templatesDir: process.env.EXPO_APP_INTENTS_TEMPLATES_DIR ?? _path().default.join(__dirname, '..', '..', TEMPLATES_DIRECTORY_NAME)
     });
 }
 const program = new (_commander()).Command();
 program.name('expo-app-intents').description('Add Apple App Intents support to Expo apps.');
-program.command('init').description('Add Expo App Intents inline-module Swift files to the current Expo app.').option('-d, --dir <directory>', 'Directory for the generated App Intents inline module.').option('--directory <directory>', 'Alias for --dir.').option('--examples <examples...>', 'Examples to include. Use "all", or choose any of: minimal, counter, restaurant, mail.').action(runInitCommand);
+program.command('init').description('Add Expo App Intents inline-module Swift files to the current Expo app.').option('-d, --dir <directory>', 'Directory for the generated App Intents inline module.').option('--directory <directory>', 'Alias for --dir.').option('--examples <examples...>', 'Example native code to scaffold. Use "all", or choose any of: minimal, counter, ' + 'restaurant, mail.').option('--visual-intelligence', 'Extend the mail example with Spotlight indexing, a Transferable export, and an open intent.').action(runInitCommand);
 program.parseAsync(process.argv).catch((error)=>{
     console.error(error.message);
     process.exitCode = 1;

package/cli/build/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["index.ts"],"sourcesContent":[null],"names":["isInteractive","TEMPLATES_DIRECTORY_NAME","ci","process","env","CI","toLowerCase","EXPO_NONINTERACTIVE","stdin","isTTY","runInitCommand","options","interactive","directory","normalizeDirectory","dir","examples","resolveExamplesAsync","runInit","projectRoot","cwd","templatesDir","EXPO_APP_INTENTS_TEMPLATES_DIR","path","join","__dirname","program","Command","name","description","command","option","action","parseAsync","argv","catch","error","console","message","exitCode"],"mappings":";;;;+BAiBgBA;;;eAAAA;;;;yBAjBQ;;;;;;;gEACP;;;;;;sBAEiD;;;;;;AAQlE,MAAMC,2BAA2B;AAM1B,SAASD;IACd,MAAME,KAAKC,QAAQC,GAAG,CAACC,EAAE;IACzB,IAAIH,OAAO,OAAOA,IAAII,kBAAkB,QAAQ;QAC9C,OAAO;IACT;IACA,IAAIH,QAAQC,GAAG,CAACG,mBAAmB,EAAE;QACnC,OAAO;IACT;IACA,IAAI,CAACJ,QAAQK,KAAK,CAACC,KAAK,EAAE;QACxB,OAAO;IACT;IACA,OAAO;AACT;AAEA,eAAeC,eAAeC,OAA2B;IACvD,MAAMC,cAAcZ;IACpB,MAAMa,YAAYC,IAAAA,wBAAkB,EAACH,QAAQE,SAAS,IAAIF,QAAQI,GAAG;IACrE,MAAMC,WAAW,MAAMC,IAAAA,0BAAoB,EAACL,aAAaD,QAAQK,QAAQ;IAEzE,MAAME,IAAAA,aAAO,EAAC;QACZC,aAAahB,QAAQiB,GAAG;QACxBP;QACAG;QACAK,cACElB,QAAQC,GAAG,CAACkB,8BAA8B,IAC1CC,eAAI,CAACC,IAAI,CAACC,WAAW,MAAM,MAAMxB;IACrC;AACF;AAEA,MAAMyB,UAAU,IAAIC,CAAAA,YAAM,SAAC;AAE3BD,QAAQE,IAAI,CAAC,oBAAoBC,WAAW,CAAC;AAE7CH,QACGI,OAAO,CAAC,QACRD,WAAW,CAAC,2EACZE,MAAM,CAAC,yBAAyB,0DAChCA,MAAM,CAAC,2BAA2B,oBAClCA,MAAM,CACL,4BACA,yFAEDC,MAAM,CAACtB;AAEVgB,QAAQO,UAAU,CAAC9B,QAAQ+B,IAAI,EAAEC,KAAK,CAAC,CAACC;IACtCC,QAAQD,KAAK,CAACA,MAAME,OAAO;IAC3BnC,QAAQoC,QAAQ,GAAG;AACrB"}
+{"version":3,"sources":["index.ts"],"sourcesContent":[null],"names":["isInteractive","TEMPLATES_DIRECTORY_NAME","ci","process","env","CI","toLowerCase","EXPO_NONINTERACTIVE","stdin","isTTY","printScaffoldIntro","directory","console","log","runInitCommand","options","interactive","normalizeDirectory","dir","examples","visualIntelligence","resolveExamplesAsync","runInit","projectRoot","cwd","templatesDir","EXPO_APP_INTENTS_TEMPLATES_DIR","path","join","__dirname","program","Command","name","description","command","option","action","parseAsync","argv","catch","error","message","exitCode"],"mappings":";;;;+BAkBgBA;;;eAAAA;;;;yBAlBQ;;;;;;;gEACP;;;;;;sBAEiD;;;;;;AASlE,MAAMC,2BAA2B;AAM1B,SAASD;IACd,MAAME,KAAKC,QAAQC,GAAG,CAACC,EAAE;IACzB,IAAIH,OAAO,OAAOA,IAAII,kBAAkB,QAAQ;QAC9C,OAAO;IACT;IACA,IAAIH,QAAQC,GAAG,CAACG,mBAAmB,EAAE;QACnC,OAAO;IACT;IACA,IAAI,CAACJ,QAAQK,KAAK,CAACC,KAAK,EAAE;QACxB,OAAO;IACT;IACA,OAAO;AACT;AAEA,qFAAqF,GACrF,SAASC,mBAAmBC,SAAiB;IAC3CC,QAAQC,GAAG,CACT,CAAC,oFAAoF,CAAC,GACpF,CAAC,6BAA6B,EAAEF,UAAU,wCAAwC,CAAC;AAEzF;AAEA,eAAeG,eAAeC,OAA2B;IACvD,MAAMC,cAAchB;IACpB,MAAMW,YAAYM,IAAAA,wBAAkB,EAACF,QAAQJ,SAAS,IAAII,QAAQG,GAAG;IACrER,mBAAmBC;IACnB,MAAM,EAAEQ,QAAQ,EAAEC,kBAAkB,EAAE,GAAG,MAAMC,IAAAA,0BAAoB,EACjEL,aACAD,QAAQI,QAAQ,EAChBJ,QAAQK,kBAAkB,IAAI;IAGhC,MAAME,IAAAA,aAAO,EAAC;QACZC,aAAapB,QAAQqB,GAAG;QACxBb;QACAQ;QACAC;QACAK,cACEtB,QAAQC,GAAG,CAACsB,8BAA8B,IAC1CC,eAAI,CAACC,IAAI,CAACC,WAAW,MAAM,MAAM5B;IACrC;AACF;AAEA,MAAM6B,UAAU,IAAIC,CAAAA,YAAM,SAAC;AAE3BD,QAAQE,IAAI,CAAC,oBAAoBC,WAAW,CAAC;AAE7CH,QACGI,OAAO,CAAC,QACRD,WAAW,CAAC,2EACZE,MAAM,CAAC,yBAAyB,0DAChCA,MAAM,CAAC,2BAA2B,oBAClCA,MAAM,CACL,4BACA,qFACE,qBAEHA,MAAM,CACL,yBACA,+FAEDC,MAAM,CAACtB;AAEVgB,QAAQO,UAAU,CAAClC,QAAQmC,IAAI,EAAEC,KAAK,CAAC,CAACC;IACtC5B,QAAQ4B,KAAK,CAACA,MAAMC,OAAO;IAC3BtC,QAAQuC,QAAQ,GAAG;AACrB"}

package/cli/build/init.d.ts

@@ -6,12 +6,39 @@ export type InitOptions = {
     directory: string;
     examples: InitExample[];
     templatesDir: string;
+    /**
+     * Adds Spotlight indexing, a `Transferable` export, and an open intent on top of the mail
+     * example, and has the setup module register the entity kind so `appEntityIdentifier()` works
+     * from JavaScript.
+     */
+    visualIntelligence?: boolean;
 };
 export declare const DEFAULT_DIRECTORY = "app-intents";
+/** The example that `--visual-intelligence` extends. */
+export declare const VISUAL_INTELLIGENCE_EXAMPLE: InitExample;
 export declare function resolveExamples(values: readonly string[] | undefined): InitExample[];
 export declare function getExamplesPrompt(): PromptObject;
-export declare function resolveExamplesAsync(interactive: boolean, values: readonly string[] | undefined): Promise<InitExample[]>;
+/**
+ * Asked only after the example it extends has been selected, which is why it is a follow-up prompt
+ * rather than an entry in the picker: a `prompts` multiselect cannot enable a choice in response to
+ * another choice being selected.
+ */
+export declare function getVisualIntelligencePrompt(): PromptObject;
+export type ResolvedExamples = {
+    examples: InitExample[];
+    visualIntelligence: boolean;
+};
+export declare function resolveExamplesAsync(interactive: boolean, values: readonly string[] | undefined, visualIntelligence?: boolean): Promise<ResolvedExamples>;
 export declare function normalizeDirectory(directory: string | undefined): string;
+/**
+ * Throws when `--visual-intelligence` was requested without the example it extends, rather than
+ * scaffolding the flag away silently.
+ *
+ * The flag reaches this check from the interactive picker too — it is passed on the command line
+ * while the examples are chosen in the prompt — so the message cannot assume that passing
+ * `--examples` is the only way out.
+ */
+export declare function assertVisualIntelligenceSelection(examples: readonly InitExample[], visualIntelligence: boolean): void;
 /**
  * Scaffolds App Intents support into an Expo app:
  * 1. copies starter Swift files without overwriting user-owned files,