react-native-tapline 1.3.1 → 1.5.0

package/dist/locale.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Language, region and text size as `app_command` names (AGENT-TOOLS 16.3). The names and their
+ * values are shared with Tapwright, so an agent gets the same `bad_params` wherever the app registers them.
+ */
+/** Text sizes and the font scale each means (the number React Native reports as `fontScale`). */
+export declare const TEXT_SIZE_SCALES: {
+    readonly xs: 0.82;
+    readonly s: 0.88;
+    readonly m: 0.94;
+    readonly l: 1;
+    readonly xl: 1.12;
+    readonly xxl: 1.24;
+    readonly xxxl: 1.35;
+    readonly ax1: 1.65;
+    readonly ax2: 1.94;
+    readonly ax3: 2.35;
+    readonly ax4: 2.76;
+    readonly ax5: 3.12;
+};
+export type TextSize = keyof typeof TEXT_SIZE_SCALES;
+export declare const TEXT_SIZES: TextSize[];
+export declare function isTextSize(value: unknown): value is TextSize;
+/** Names the SDK provides itself that an app cannot replace (`appearance` can be replaced, as in 1.3). */
+export declare const RESERVED_COMMANDS: readonly string[];
+/** A BCP 47 code such as `ar` or `en-GB`. */
+export declare function parseLanguage(args: Record<string, unknown>): string;
+/** An ISO 3166 alpha-2 country code such as `QA` (returned in upper case). */
+export declare function parseRegion(args: Record<string, unknown>): string;
+/** `system` clears the override and goes back to the phone's own text size. */
+export declare const SYSTEM_TEXT_SIZE = "system";
+export declare function parseTextSize(args: Record<string, unknown>): TextSize | typeof SYSTEM_TEXT_SIZE;
+/** True for a language written right to left (ar, he, fa, ur). */
+export declare function isRtlLanguage(language: string): boolean;
+/**
+ * The font scale to use: the one an agent set with `text_size`, else the system's. Calling it counts as using the helper.
+ * It already holds the system's scale, so text sized with it sets `allowFontScaling={false}` (else the system scale
+ * applies twice).
+ */
+export declare function getTaplineFontScale(): number;
+/** Calls `listener` when the override changes; returns the function that stops it. A live subscriber counts as using the helper. */
+export declare function subscribeTaplineFontScale(listener: () => void): () => void;
+/**
+ * The font scale the app should apply to its text: the size an agent set with the `text_size`
+ * command, else the system's. React Native reads the system scale natively, so Tapline cannot
+ * change it; an app that multiplies its font sizes by this value opts in to `text_size`. The value already
+ * holds the system's scale: that text sets `allowFontScaling={false}`, so the system scale applies once.
+ *
+ *     const scale = useTaplineFontScale();
+ *     <Text allowFontScaling={false} style={{ fontSize: 16 * scale }}>…</Text>
+ */
+export declare function useTaplineFontScale(): number;
+/** True while a hook or subscriber is live (a mounted `useTaplineFontScale`), or the app has called the getter this session. */
+export declare function fontScaleHelperUsed(): boolean;
+export declare function setTaplineFontScale(scale: number | null): void;
+/** The session ended (host gone, Tapline stopped): the phone's own text size again, and the getter no longer counts as used. */
+export declare function resetTaplineTextSize(): void;
+/** Forgets the override and that the helper was used (tests). */
+export declare function resetFontScale(): void;
+/** `1.12×`, `1×`: the scale as the answer writes it. */
+export declare function formatScale(scale: number): string;
+export declare const TEXT_SIZE_UNSUPPORTED = "This app doesn't use Tapline's font-scale helper (useTaplineFontScale), and React Native reads the system text size natively. To check large text, use audit's dynamic_type check or Tapwright's open_app { text_size }.";
+/** The built-in `text_size` run: validates, then sets the override. */
+export declare function runTextSize(args: Record<string, unknown>): {
+    size: TextSize | typeof SYSTEM_TEXT_SIZE;
+    scale: number;
+    say: string;
+};

package/dist/locale.js

@@ -0,0 +1,224 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEXT_SIZE_UNSUPPORTED = exports.SYSTEM_TEXT_SIZE = exports.RESERVED_COMMANDS = exports.TEXT_SIZES = exports.TEXT_SIZE_SCALES = void 0;
+exports.isTextSize = isTextSize;
+exports.parseLanguage = parseLanguage;
+exports.parseRegion = parseRegion;
+exports.parseTextSize = parseTextSize;
+exports.isRtlLanguage = isRtlLanguage;
+exports.getTaplineFontScale = getTaplineFontScale;
+exports.subscribeTaplineFontScale = subscribeTaplineFontScale;
+exports.useTaplineFontScale = useTaplineFontScale;
+exports.fontScaleHelperUsed = fontScaleHelperUsed;
+exports.setTaplineFontScale = setTaplineFontScale;
+exports.resetTaplineTextSize = resetTaplineTextSize;
+exports.resetFontScale = resetFontScale;
+exports.formatScale = formatScale;
+exports.runTextSize = runTextSize;
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const types_1 = require("./types");
+/**
+ * Language, region and text size as `app_command` names (AGENT-TOOLS 16.3). The names and their
+ * values are shared with Tapwright, so an agent gets the same `bad_params` wherever the app registers them.
+ */
+/** Text sizes and the font scale each means (the number React Native reports as `fontScale`). */
+exports.TEXT_SIZE_SCALES = {
+    xs: 0.82,
+    s: 0.88,
+    m: 0.94,
+    l: 1.0,
+    xl: 1.12,
+    xxl: 1.24,
+    xxxl: 1.35,
+    ax1: 1.65,
+    ax2: 1.94,
+    ax3: 2.35,
+    ax4: 2.76,
+    ax5: 3.12,
+};
+exports.TEXT_SIZES = Object.keys(exports.TEXT_SIZE_SCALES);
+function isTextSize(value) {
+    return typeof value === 'string' && Object.prototype.hasOwnProperty.call(exports.TEXT_SIZE_SCALES, value);
+}
+/** Names the SDK provides itself that an app cannot replace (`appearance` can be replaced, as in 1.3). */
+exports.RESERVED_COMMANDS = ['network', 'text_size'];
+// --- validation ---------------------------------------------------------------------------------------------
+const LANGUAGE = /^[A-Za-z]{2,3}$/;
+const SUBTAG = /^[A-Za-z0-9]{2,8}$/;
+const PRIVATE_SUBTAG = /^[A-Za-z0-9]{1,8}$/;
+const SINGLETON = /^[A-Za-z0-9]$/;
+const MAX_LANGUAGE_TAG = 128;
+/**
+ * BCP 47, read subtag by subtag (linear: a regex with nested repeats can take seconds on a long bad tag): a language
+ * of 2-3 letters, then subtags of 2-8. A singleton starts an extension (`u-ca-gregory`), which needs one or more
+ * subtags of 2-8; `x` starts the private-use part (`x-a`), which needs one or more of 1-8 and runs to the end.
+ */
+function isLanguageTag(value) {
+    if (value.length > MAX_LANGUAGE_TAG)
+        return false;
+    const parts = value.split('-');
+    if (!LANGUAGE.test(parts[0] ?? ''))
+        return false;
+    let i = 1;
+    while (i < parts.length) {
+        const part = parts[i];
+        if (!SINGLETON.test(part)) {
+            if (!SUBTAG.test(part))
+                return false;
+            i++;
+            continue;
+        }
+        const privateUse = part.toLowerCase() === 'x';
+        const fits = privateUse ? PRIVATE_SUBTAG : SUBTAG;
+        let n = 0;
+        i++;
+        while (i < parts.length && (privateUse || !SINGLETON.test(parts[i]))) {
+            if (!fits.test(parts[i]))
+                return false;
+            n++;
+            i++;
+        }
+        if (n === 0)
+            return false;
+    }
+    return true;
+}
+const REGION_CODE = /^[A-Za-z]{2}$/;
+function badParams(message) {
+    return new types_1.TaplineError('bad_params', message);
+}
+/** A BCP 47 code such as `ar` or `en-GB`. */
+function parseLanguage(args) {
+    const value = args.language;
+    if (typeof value !== 'string' || !isLanguageTag(value)) {
+        throw badParams('language must be a BCP 47 code such as "ar" or "en-GB"');
+    }
+    return value;
+}
+/** An ISO 3166 alpha-2 country code such as `QA` (returned in upper case). */
+function parseRegion(args) {
+    const value = args.region;
+    if (typeof value !== 'string' || !REGION_CODE.test(value)) {
+        throw badParams('region must be an ISO 3166 country code such as "QA"');
+    }
+    return value.toUpperCase();
+}
+/** `system` clears the override and goes back to the phone's own text size. */
+exports.SYSTEM_TEXT_SIZE = 'system';
+function parseTextSize(args) {
+    const value = args.size;
+    if (value === exports.SYSTEM_TEXT_SIZE)
+        return value;
+    if (!isTextSize(value)) {
+        throw badParams(`size must be one of ${exports.TEXT_SIZES.join(', ')}, or "system" for the phone's own`);
+    }
+    return value;
+}
+// --- right-to-left ------------------------------------------------------------------------------------------
+const RTL_LANGUAGES = new Set(['ar', 'he', 'fa', 'ur']);
+/** True for a language written right to left (ar, he, fa, ur). */
+function isRtlLanguage(language) {
+    const primary = language.split('-')[0]?.toLowerCase() ?? '';
+    return RTL_LANGUAGES.has(primary);
+}
+// --- font scale override ------------------------------------------------------------------------------------
+let override = null;
+let getterUsed = false;
+const listeners = new Set();
+function emit() {
+    for (const listener of [...listeners]) {
+        try {
+            listener();
+        }
+        catch {
+            // one failing subscriber must not stop the others, or the session reset
+        }
+    }
+}
+function currentScale() {
+    return override ?? react_native_1.PixelRatio.getFontScale();
+}
+/**
+ * The font scale to use: the one an agent set with `text_size`, else the system's. Calling it counts as using the helper.
+ * It already holds the system's scale, so text sized with it sets `allowFontScaling={false}` (else the system scale
+ * applies twice).
+ */
+function getTaplineFontScale() {
+    getterUsed = true;
+    return currentScale();
+}
+/** Calls `listener` when the override changes; returns the function that stops it. A live subscriber counts as using the helper. */
+function subscribeTaplineFontScale(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/**
+ * The font scale the app should apply to its text: the size an agent set with the `text_size`
+ * command, else the system's. React Native reads the system scale natively, so Tapline cannot
+ * change it; an app that multiplies its font sizes by this value opts in to `text_size`. The value already
+ * holds the system's scale: that text sets `allowFontScaling={false}`, so the system scale applies once.
+ *
+ *     const scale = useTaplineFontScale();
+ *     <Text allowFontScaling={false} style={{ fontSize: 16 * scale }}>…</Text>
+ */
+function useTaplineFontScale() {
+    const [scale, setScale] = (0, react_1.useState)(currentScale);
+    (0, react_1.useEffect)(() => {
+        const update = () => setScale(currentScale());
+        const stop = subscribeTaplineFontScale(update);
+        update();
+        return stop;
+    }, []);
+    return scale;
+}
+/** True while a hook or subscriber is live (a mounted `useTaplineFontScale`), or the app has called the getter this session. */
+function fontScaleHelperUsed() {
+    return listeners.size > 0 || getterUsed;
+}
+function setTaplineFontScale(scale) {
+    override = scale;
+    emit();
+}
+/** The session ended (host gone, Tapline stopped): the phone's own text size again, and the getter no longer counts as used. */
+function resetTaplineTextSize() {
+    const changed = override !== null;
+    override = null;
+    getterUsed = false;
+    if (changed)
+        emit();
+}
+/** Forgets the override and that the helper was used (tests). */
+function resetFontScale() {
+    override = null;
+    getterUsed = false;
+    listeners.clear();
+}
+/** `1.0×`, `1.3×`: the phone's own scale as the answer writes it (always one decimal at least). */
+function formatSystemScale(scale) {
+    const text = String(Number(scale.toFixed(2)));
+    return `${text.includes('.') ? text : `${text}.0`}×`;
+}
+/** `1.12×`, `1×`: the scale as the answer writes it. */
+function formatScale(scale) {
+    return `${Number(scale.toFixed(2))}×`;
+}
+exports.TEXT_SIZE_UNSUPPORTED = "This app doesn't use Tapline's font-scale helper (useTaplineFontScale), and React Native reads the system text size natively. To check large text, use audit's dynamic_type check or Tapwright's open_app { text_size }.";
+/** The built-in `text_size` run: validates, then sets the override. */
+function runTextSize(args) {
+    const size = parseTextSize(args);
+    // "system" always clears an override, also once the screens that used the helper are gone
+    if (size !== exports.SYSTEM_TEXT_SIZE && !fontScaleHelperUsed())
+        throw new types_1.TaplineError('unsupported', exports.TEXT_SIZE_UNSUPPORTED);
+    if (size === exports.SYSTEM_TEXT_SIZE) {
+        setTaplineFontScale(null);
+        const scale = react_native_1.PixelRatio.getFontScale();
+        return { size, scale, say: `Text size: the phone's own (${formatSystemScale(scale)}).` };
+    }
+    const scale = exports.TEXT_SIZE_SCALES[size];
+    setTaplineFontScale(scale);
+    return { size, scale, say: `Text size ${size} (${formatScale(scale)}).` };
+}
+//# sourceMappingURL=locale.js.map

package/dist/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../src/locale.ts"],"names":[],"mappings":"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"}

package/dist/logs.d.ts

@@ -12,5 +12,7 @@ export declare function clearLogs(): void;
 export declare function setLogSink(next: LogSink | null): void;
 /** The unpatched console.log, for Tapline's own one-line status messages. */
 export declare function originalLog(...args: unknown[]): void;
+/** The unpatched console.warn, for Tapline's own notices to the developer (not captured as an app log). */
+export declare function originalWarn(...args: unknown[]): void;
 export declare function installLogs(): void;
 export declare function uninstallLogs(): void;

package/dist/logs.js

@@ -8,6 +8,7 @@ exports.getLogEntries = getLogEntries;
 exports.clearLogs = clearLogs;
 exports.setLogSink = setLogSink;
 exports.originalLog = originalLog;
+exports.originalWarn = originalWarn;
 exports.installLogs = installLogs;
 exports.uninstallLogs = uninstallLogs;
 const crash_1 = require("./crash");
@@ -130,6 +131,12 @@ function originalLog(...args) {
     if (typeof log === 'function')
         log.apply(console, args);
 }
+/** The unpatched console.warn, for Tapline's own notices to the developer (not captured as an app log). */
+function originalWarn(...args) {
+    const warn = originals.get('warn') ?? consoleOf().warn;
+    if (typeof warn === 'function')
+        warn.apply(console, args);
+}
 function installLogs() {
     if (installed)
         return;

package/dist/logs.js.map

@@ -1 +1 @@
-{"version":3,"file":"logs.js","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":";;;AA2DA,gCAGC;AAkBD,wBAKC;AAED,kCAyBC;AAGD,sCAGC;AAED,8BAEC;AAGD,gCAEC;AAGD,kCAGC;AAGD,oCAGC;AAED,kCAkDC;AAED,sCAgBC;AAjND,mCAAuE;AACvE,mCAAsF;AAEzE,QAAA,eAAe,GAAG,GAAG,CAAC;AACnC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAY/B,MAAM,MAAM,GAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAErE,MAAM,MAAM,GAAe,EAAE,CAAC;AAC9B,IAAI,IAAI,GAAmB,IAAI,CAAC;AAChC,IAAI,SAAS,GAAG,KAAK,CAAC;AACtB,IAAI,SAAS,GAAG,KAAK,CAAC;AACtB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuB,CAAC;AACjD,IAAI,eAAyC,CAAC;AAC9C,IAAI,UAAU,GAAwB,IAAI,CAAC;AAC3C,iGAAiG;AACjG,MAAM,WAAW,GAAG,IAAI,OAAO,EAAgB,CAAC;AAChD,IAAI,cAAc,GAAwB,IAAI,CAAC;AAE/C,SAAS,SAAS;IAChB,OAAO,OAA6C,CAAC;AACvD,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,KAAK,GAAI,UAAuC,CAAC,UAAU,CAAC;IAClE,OAAO,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAwB,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5D,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACpF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,aAAc,KAA2B,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC;IACzG,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAa,EAAE,EAAE;YACzD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC9C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,OAAO,YAAY,CAAC;gBACxC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;YACD,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAgB,UAAU,CAAC,IAAe;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACzF,CAAC;AAED,SAAS,IAAI,CAAC,KAAe;IAC3B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,IAAI,MAAM,CAAC,MAAM,GAAG,uBAAe;QAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,uBAAe,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,IAAI,CAAC,KAAsB,EAAE,IAA+B;IACnE,MAAM,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;IAC7C,CAAC;AACH,CAAC;AAED,6DAA6D;AAC7D,SAAgB,MAAM,CAAC,KAAe,EAAE,OAAe,EAAE,KAAa,IAAI,CAAC,GAAG,EAAE;IAC9E,MAAM,KAAK,GAAa,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC/C,IAAI,CAAC,KAAK,CAAC,CAAC;IACZ,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,WAAW,CAAC,KAAc,EAAE,KAAc;IACxD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,qGAAqG;IACrG,6EAA6E;IAC7E,MAAM,KAAK,GAAG,IAAA,sBAAc,EAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxC,IAAA,iBAAS,EAAC,KAAK,CAAC,CAAC;IACjB,IAAI,CAAC,OAAO,EAAE;QACZ,OAAO;QACP,KAAK;QACL,KAAK;QACL,EAAE;QACF,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxF,CAAC,CAAC;IACH,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,EAAE,CAAC;QAC9C,sGAAsG;QACtG,KAAK,IAAA,yBAAiB,GAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,SAAgB,aAAa,CAAC,KAAc;IAC1C,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7F,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,SAAS;IACvB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;AACpB,CAAC;AAED,2EAA2E;AAC3E,SAAgB,UAAU,CAAC,IAAoB;IAC7C,IAAI,GAAG,IAAI,CAAC;AACd,CAAC;AAED,6EAA6E;AAC7E,SAAgB,WAAW,CAAC,GAAG,IAAe;IAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAK,SAAS,EAAE,CAAC,GAA6B,CAAC;IAC/E,IAAI,OAAO,GAAG,KAAK,UAAU;QAAE,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,2GAA2G;AAC3G,SAAgB,YAAY,CAAC,GAAG,IAAe;IAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAK,SAAS,EAAE,CAAC,IAA8B,CAAC;IAClF,IAAI,OAAO,IAAI,KAAK,UAAU;QAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,SAAgB,WAAW;IACzB,IAAI,SAAS;QAAE,OAAO;IACtB,SAAS,GAAG,IAAI,CAAC;IAEjB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,OAAO,QAAQ,KAAK,UAAU;YAAE,SAAS;QAC7C,MAAM,UAAU,GAAG,QAAqB,CAAC;QACzC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACjC,MAAM,OAAO,GAAc,CAAC,GAAG,IAAe,EAAQ,EAAE;YACtD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAS,GAAG,IAAI,CAAC;gBACjB,IAAI,CAAC;oBACH,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;gBAClC,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;wBAAS,CAAC;oBACT,SAAS,GAAG,KAAK,CAAC;gBACpB,CAAC;YACH,CAAC;YACD,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;QAC1D,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,gBAAgB,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACrG,4GAA4G;QAC5G,eAAe,GAAG,QAAQ,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9F,MAAM,QAAQ,GAAG,eAAe,CAAC;QACjC,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,MAAM,OAAO,GAAiB,CAAC,KAAc,EAAE,OAAiB,EAAQ,EAAE;YACxE,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC;oBACH,WAAW,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC;gBACvC,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;YACH,CAAC;YACD,IAAI,QAAQ;gBAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC,CAAC;QACF,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzB,UAAU,GAAG,OAAO,CAAC;QACrB,cAAc,GAAG,GAAG,EAAE;YACpB,IAAI,GAAG,KAAK,CAAC;QACf,CAAC,CAAC;QACF,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,SAAgB,aAAa;IAC3B,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,SAAS,GAAG,KAAK,CAAC;IAClB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,SAAS;QAAE,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;IACpE,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,gBAAgB,KAAK,UAAU,IAAI,UAAU,EAAE,CAAC;QACxE,IAAI,eAAe;YAAE,KAAK,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;IAC/D,CAAC;IACD,0GAA0G;IAC1G,IAAI,cAAc;QAAE,cAAc,EAAE,CAAC;IACrC,cAAc,GAAG,IAAI,CAAC;IACtB,eAAe,GAAG,SAAS,CAAC;IAC5B,UAAU,GAAG,IAAI,CAAC;IAClB,IAAI,GAAG,IAAI,CAAC;AACd,CAAC"}

package/dist/media.d.ts

@@ -0,0 +1,71 @@
+interface ExpoMediaLibrary {
+    createAssetAsync: (uri: string) => Promise<unknown>;
+    deleteAssetsAsync: (ids: string[]) => Promise<unknown>;
+    getPermissionsAsync: (writeOnly?: boolean) => Promise<unknown>;
+    requestPermissionsAsync: (writeOnly?: boolean) => Promise<unknown>;
+}
+interface CameraRollModule {
+    save: (uri: string, options?: {
+        type?: string;
+    }) => Promise<unknown>;
+    deletePhotos: (uris: string[]) => Promise<unknown>;
+}
+interface FileSystemModule {
+    cacheDirectory: string;
+    writeAsStringAsync: (uri: string, contents: string, options: {
+        encoding: string;
+    }) => Promise<unknown>;
+    deleteAsync: (uri: string, options?: {
+        idempotent?: boolean;
+    }) => Promise<unknown>;
+}
+type PickerModule = Record<string, unknown>;
+export interface MediaModules {
+    expo: ExpoMediaLibrary | null;
+    cameraRoll: CameraRollModule | null;
+    fileSystem: FileSystemModule | null;
+    imagePicker: PickerModule | null;
+}
+/** Replace the optional modules (tests); undefined restores the lookup. */
+export declare function setMediaModules(next: MediaModules | undefined): void;
+/** How long an OS prompt is waited for before the answer says a person must (tests shorten it). */
+export declare function setMediaPatience(ms: number): void;
+/** The asset ids this session has added and not yet removed. */
+export declare function addedAssetIds(): readonly string[];
+export interface AddOutcome {
+    /** The new asset's id; absent when a person must answer the OS prompt first. */
+    id?: string;
+    needsPerson?: boolean;
+    /** Ids of earlier saves that finished after their `needsPerson` answer; the host remembers them. */
+    late?: string[];
+}
+export interface RemoveOutcome {
+    removed: number;
+    /** The person has not answered the OS delete confirmation yet. */
+    pending?: boolean;
+    /** The person declined the delete; the pictures stay (and stay remembered). */
+    declined?: boolean;
+}
+/** A picture handed to a photo picker, as an `expo-image-picker` asset describes it. */
+export interface TaplinePickerPicture {
+    uri: string;
+    fileName: string;
+    mimeType: string;
+    width: number;
+    height: number;
+    base64: string;
+}
+/** What a hook receives when pictures are armed for the app's own picker. */
+export type TaplinePickerHook = (pictures: readonly TaplinePickerPicture[]) => void | Promise<void>;
+/**
+ * For an app whose photo picker is not expo-image-picker: called when the agent arms test pictures
+ * (`media` with `picker: true`), so the app can hand them to its own picker once. Returns the unregister function.
+ */
+export declare function registerTaplinePickerHook(hook: TaplinePickerHook): () => void;
+/** Puts the picker back as the app made it and forgets pictures not yet used. Called after one use and on disconnect. */
+export declare function resetMedia(): void;
+/** Whether a picker stub is waiting for its one use. */
+export declare function pickerArmed(): boolean;
+/** `media {op: "add" | "remove" | "picker", ...}` (AGENT-TOOLS 1.12 §17.6). One picture per `add` and `picker` request. */
+export declare function media(rawParams: unknown): Promise<unknown>;
+export {};