tripilot-react-native 0.0.0-stage → 0.2.0-alpha.10

package/LICENSE

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

package/README.md

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# TriPilot React Native helper
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[English](README.md) · [Português](README.pt-BR.md)
+
+Optional helper for TriPilot E2E. It adds test/accessibility properties without AI models, ADB, OCR or Node dependencies in the mobile bundle. Android testing works without this helper. iOS E2E is under construction and unavailable.
+
+```sh
+pnpm add tripilot-react-native@alpha
+pnpm add -D tripilot-e2e@alpha
+```
+
+```tsx
+import { e2e } from 'tripilot-react-native';
+<Pressable {...e2e('save-profile', 'Save profile')} onPress={save} />
+```
+
+`e2e(id, label?)` sets `testID`, `collapsable: false` and an optional accessibility label. Avoid grouping all children into one accessible element when tests need individual identities.
+
+The optional Expo config plugin's `allowLocalHttp` enables Android HTTP only when explicitly true; default leaves the manifest unchanged. ADB E2E does not require it. Install the E2E executor separately on the development/CI host as a devDependency. [Natural-language quick start](https://www.npmjs.com/package/tripilot-e2e).
+
+The private GitHub distribution is configured as `@sto11/tripilot-react-native`; public npm uses the name above. The GitHub repository remains private.

package/README.pt-BR.md

@@ -0,0 +1,21 @@
+# Helper TriPilot React Native
+
+[English](README.md) · [Português](README.pt-BR.md)
+
+Helper opcional que adiciona propriedades de teste/acessibilidade, sem IA, ADB, OCR ou dependências Node no bundle do app. O E2E Android funciona sem esse helper. iOS E2E está em construção e indisponível.
+
+```sh
+pnpm add tripilot-react-native@alpha
+pnpm add -D tripilot-e2e@alpha
+```
+
+```tsx
+import { e2e } from 'tripilot-react-native';
+<Pressable {...e2e('save-profile', 'Salvar perfil')} onPress={save} />
+```
+
+`e2e(id, label?)` define `testID`, `collapsable: false` e label acessível opcional. Evite agrupar todos os filhos em um único elemento acessível quando precisar testar suas identidades separadas.
+
+O plugin Expo opcional tem `allowLocalHttp`, que habilita HTTP Android só quando explicitamente true; o padrão preserva o manifest. ADB E2E não exige essa opção. Instale o executor no computador/CI como devDependency. [Guia com linguagem natural](https://www.npmjs.com/package/tripilot-e2e).
+
+A distribuição privada do GitHub está configurada como `@sto11/tripilot-react-native`; npm público usa o nome acima. O repositório GitHub continua privado.

package/app.plugin.js

@@ -0,0 +1,11 @@
+const { withAndroidManifest } = require('expo/config-plugins');
+
+/** Explicit opt-in for an HTTP mock API in a development app. Default is no change. */
+module.exports = function withTriPilot(config, options = {}) {
+  if (!options.allowLocalHttp) return config;
+  return withAndroidManifest(config, (result) => {
+    const application = result.modResults.manifest.application?.[0];
+    if (application) application.$['android:usesCleartextTraffic'] = 'true';
+    return result;
+  });
+};

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { ViewProps } from 'react-native';
+/** Stable test IDs; keep accessibility labels useful to people using screen readers. */
+export declare function e2e(id: string, label?: string): Pick<ViewProps, 'testID' | 'accessibilityLabel' | 'collapsable'>;

package/dist/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.e2e = e2e;
+/** Stable test IDs; keep accessibility labels useful to people using screen readers. */
+function e2e(id, label) {
+    if (!/^[a-zA-Z][a-zA-Z0-9._-]*$/.test(id))
+        throw new Error(`Invalid E2E ID: ${id}`);
+    return { testID: id, collapsable: false, ...(label ? { accessibilityLabel: label } : {}) };
+}

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "tripilot-react-native",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0-alpha.10",
+  "description": "Small React Native helpers and opt-in Expo configuration for TriPilot E2E.",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "react-native": "./src/index.ts",
+  "files": [
+    "dist",
+    "src",
+    "app.plugin.js",
+    "README.md",
+    "README.pt-BR.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepack": "npm run build"
+  },
+  "peerDependencies": {
+    "react-native": ">=0.76",
+    "expo": ">=54"
+  },
+  "peerDependenciesMeta": {
+    "expo": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/STO11/tripilot.git",
+    "directory": "packages/react-native"
+  },
+  "homepage": "https://www.npmjs.com/package/tripilot-react-native",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,7 @@
+import type { ViewProps } from 'react-native';
+
+/** Stable test IDs; keep accessibility labels useful to people using screen readers. */
+export function e2e(id: string, label?: string): Pick<ViewProps, 'testID' | 'accessibilityLabel' | 'collapsable'> {
+  if (!/^[a-zA-Z][a-zA-Z0-9._-]*$/.test(id)) throw new Error(`Invalid E2E ID: ${id}`);
+  return { testID: id, collapsable: false, ...(label ? { accessibilityLabel: label } : {}) };
+}