@vvedantb/native-ui 0.7.0 → 0.8.0

package/README.md

@@ -68,7 +68,7 @@ The root entry exports everything. It still imports `BottomSheetContainer` and `
 | `@vvedantb/native-ui/toast` | `toast`, `Toaster`, `ToastOptions`, `ToastVariant` | none (from 0.3.12) |
 | `@vvedantb/native-ui/theme` | `NativeUiProvider`, `useNativeUi`, `useLargerText`, `useAccentColor`, `DEFAULT_ACCENT`, `tokens`, `palette`, `withAlpha`, `fontClass`, `cn`, `Colors` and the colour constants | none |
 | `@vvedantb/native-ui/floating` | `FloatingSurface`, `GlassSheetBackground`, `LiquidGlass`, `GlassBlurProvider`, `GlassBlurTarget`, `FloatingFAB`, `useReduceTransparency`, the floating metrics and styles | `expo-blur` (loader) |
-| `@vvedantb/native-ui/layout` | `ScreenContainer`, `SafeAreaContainer`, `PageTitle`, `PageHeader`, `StackPageHeader` (0.5.0) and their props types, `SectionLabel` (0.5.0), `SettingsSection`, `SettingsField`, `SettingsToggleRow`, `SettingsStack` | `expo-blur` (loader) |
+| `@vvedantb/native-ui/layout` | `ScreenContainer`, `SafeAreaContainer`, `PageTitle`, `PageHeader`, `StackPageHeader` (0.5.0) and their props types, `SectionLabel` (0.5.0), `SettingsSection`, `SettingsField`, `SettingsToggleRow`, `SettingsStack`, `MoreFromProjectV` and `FromProjectV` (0.8.0) | `expo-blur` (loader) |
 | `@vvedantb/native-ui/marketing` | `UpgradeToProCard`, `PricingModal` and the pricing types | none |
 | `@vvedantb/native-ui/ambient` | `AmbientBackground` | `expo-linear-gradient` (loader) |
 | `@vvedantb/native-ui/blur`, `/haptics` | the loaders | `expo-blur`, `expo-haptics` (loaders) |
@@ -302,6 +302,10 @@ From 0.3.12 a toast looks like the web `SonnerToaster` at its default density wi
 
 `@vvedantb/native-ui/gallery` exports `ParityGallery`, a screen that renders these components. Put it in a dev-only route to check them on a device.
 
+## More from Project V (0.8.0)
+
+`<MoreFromProjectV current="velth" />` is a settings section listing the other Project V phone apps (vibot, Verve, Velth, vmem, V Store). A row opens the app if installed, else V Store's home (`vstore://`), else its website. Add the other apps' schemes to `LSApplicationQueriesSchemes` (iOS) and `<queries>` (Android 11+), or `canOpenURL` returns `false`. `<FromProjectV />` (or `variant="footer"`) is a small "from Project V" line. `openProjectVApp(id, Linking, Platform.OS)` and `PROJECT_V_MOBILE_APPS` are exported for custom rows.
+
 ## App pieces (0.5.0)
 
 Components and props that the Verve, vibot and Velth apps need. They follow the rest of the package: Instrument Sans with its weight as a style, `tokens` and `palette` colours as styles in light and dark, a step up with larger text, 44 pt targets, and roles, names and states for VoiceOver and TalkBack.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vvedantb/native-ui",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "license": "MIT",
   "description": "Shared React Native / Expo UI primitives. Floating surfaces, forms, overlays, toasts, settings chrome, tab bar, AI chat parts, the family app marks, a NativeWind preset, the Expo web root and Clerk + Convex auth screens.",
   "type": "module",

package/src/entries/layout.ts

@@ -12,3 +12,21 @@ export { SettingsSection } from "../settings/SettingsSection";
 export { SettingsField } from "../settings/SettingsField";
 export { SettingsToggleRow } from "../settings/SettingsToggleRow";
 export { SettingsStack } from "../settings/SettingsStack";
+export { MoreFromProjectV, FromProjectV } from "../settings/MoreFromProjectV";
+export type { MoreFromProjectVProps, FromProjectVProps } from "../settings/MoreFromProjectV";
+export {
+  PROJECT_V_MOBILE_APPS,
+  projectVMobileApp,
+  otherProjectVMobileApps,
+  openProjectVApp,
+  projectVAppOpenSteps,
+  VSTORE_HOME_URL,
+  androidIntentUrl,
+} from "../settings/projectVMobileApps";
+export type {
+  ProjectVMobileApp,
+  ProjectVMobileAppId,
+  ProjectVOpenTarget,
+  ProjectVOpenStep,
+  ProjectVLinking,
+} from "../settings/projectVMobileApps";

package/src/examples/ParityGallery.tsx

@@ -54,12 +54,14 @@ import {
   DialogTitle,
   DialogTrigger,
   EmptyState,
+  FromProjectV,
   GoogleMark,
   IconButton,
   Input,
   Label,
   LabeledSwitchRow,
   ListRow,
+  MoreFromProjectV,
   NEUTRAL_900,
   NativeUiProvider,
   PageHeader,
@@ -682,6 +684,15 @@ function GalleryScreen() {
           </AmbientBackground>
         </Section>
 
+        <Section title="More from Project V">
+          {/* As in Velth's settings: the other four phone apps. A row opens the app, else V Store, else the website. */}
+          <MoreFromProjectV
+            current="velth"
+            onOpen={(id, target) => toast(target ? `Opened ${id} (${target})` : `Could not open ${id}`)}
+          />
+          <FromProjectV />
+        </Section>
+
         <Section title="Camera chrome">
           {/* A dark stand-in for the live preview. */}
           <View className="h-72 justify-between overflow-hidden rounded-lg p-4" style={{ backgroundColor: NEUTRAL_900 }}>

package/src/index.ts

@@ -164,6 +164,24 @@ export { SettingsSection } from "./settings/SettingsSection";
 export { SettingsField } from "./settings/SettingsField";
 export { SettingsToggleRow } from "./settings/SettingsToggleRow";
 export { SettingsStack } from "./settings/SettingsStack";
+export { MoreFromProjectV, FromProjectV } from "./settings/MoreFromProjectV";
+export type { MoreFromProjectVProps, FromProjectVProps } from "./settings/MoreFromProjectV";
+export {
+  PROJECT_V_MOBILE_APPS,
+  projectVMobileApp,
+  otherProjectVMobileApps,
+  openProjectVApp,
+  projectVAppOpenSteps,
+  VSTORE_HOME_URL,
+  androidIntentUrl,
+} from "./settings/projectVMobileApps";
+export type {
+  ProjectVMobileApp,
+  ProjectVMobileAppId,
+  ProjectVOpenTarget,
+  ProjectVOpenStep,
+  ProjectVLinking,
+} from "./settings/projectVMobileApps";
 export { PINK_50, PINK_100, PINK_600, PINK_700, NEUTRAL_100, NEUTRAL_500, NEUTRAL_900, Colors } from "./colors";
 // Family app marks and their pure data (copied from `@vvedantb/ui/brand`), and `GoogleMark`.
 export * from "./brand";

package/src/settings/MoreFromProjectV.tsx

@@ -0,0 +1,105 @@
+import { Linking, Platform, Text, View } from "react-native";
+import { APP_ICONS } from "../brand/AppIcons";
+import { AppMark } from "../brand/AppMark";
+import type { AppName } from "../brand/svg";
+import { cn } from "../cn";
+import { textStyle, typeStyle } from "../controlStyles";
+import { ListRow } from "../ListRow";
+import { tokens } from "../tokens";
+import { useScheme } from "../useScheme";
+import { SettingsSection } from "./SettingsSection";
+import {
+  openProjectVApp,
+  otherProjectVMobileApps,
+  type ProjectVMobileAppId,
+  type ProjectVOpenTarget,
+} from "./projectVMobileApps";
+
+/**
+ * The mark for each phone app. V Store has no mark of its own (it was left out
+ * of the brand marks in 0.3.9), so it shows the Project V mark.
+ */
+const MARK: Record<ProjectVMobileAppId, AppName> = {
+  vibot: "vibot",
+  verve: "verve",
+  velth: "velth",
+  vmem: "vmem",
+  vstore: "projectv",
+};
+
+export type FromProjectVProps = {
+  className?: string;
+  testID?: string;
+};
+
+/** A small muted "from Project V" line with the Project V mark, for the end of a settings screen. */
+export function FromProjectV({ className, testID }: FromProjectVProps) {
+  const scheme = useScheme();
+  const muted = tokens.color.muted[scheme];
+  const ProjectVMark = APP_ICONS.projectv;
+  return (
+    <View
+      testID={testID}
+      accessible
+      accessibilityLabel="from Project V"
+      className={cn("flex-row items-center justify-center gap-1.5 py-2", className)}
+    >
+      <Text className="text-sm font-instrument-sans" style={textStyle("muted", scheme)}>
+        from
+      </Text>
+      <ProjectVMark size={14} color={muted} />
+      <Text
+        className="text-sm font-instrument-sans-semibold"
+        style={[textStyle("muted", scheme), typeStyle("semibold")]}
+      >
+        Project V
+      </Text>
+    </View>
+  );
+}
+
+export type MoreFromProjectVProps = {
+  /** The app showing the section. It is left out of the list. */
+  current: ProjectVMobileAppId;
+  /** `"section"` (default): a settings section listing the other apps. `"footer"`: only the small "from Project V" line. */
+  variant?: "section" | "footer";
+  /** Section title. Default "More from Project V". */
+  title?: string;
+  /** Called after a row opens something: the app, V Store or its website (`null` if nothing opened). */
+  onOpen?: (id: ProjectVMobileAppId, target: ProjectVOpenTarget | null) => void;
+  className?: string;
+};
+
+/**
+ * Settings section listing the other Project V phone apps, each with its mark,
+ * name and one line. A row opens the app if it is installed, else V Store's
+ * home, else its website (`openProjectVApp`).
+ */
+export function MoreFromProjectV({
+  current,
+  variant = "section",
+  title = "More from Project V",
+  onOpen,
+  className,
+}: MoreFromProjectVProps) {
+  if (variant === "footer") return <FromProjectV className={className} />;
+  return (
+    <SettingsSection title={title} bodyVariant="list" className={className}>
+      <View className="flex-col gap-1 p-1">
+        {otherProjectVMobileApps(current).map((app) => (
+          <ListRow
+            key={app.id}
+            testID={`more-from-project-v-${app.id}`}
+            title={app.name}
+            meta={app.description}
+            leading={<AppMark app={MARK[app.id]} size={28} />}
+            accessibilityLabel={`${app.name}, ${app.description}`}
+            onPress={() => {
+              void openProjectVApp(app.id, Linking, Platform.OS).then((target) => onOpen?.(app.id, target));
+            }}
+          />
+        ))}
+      </View>
+    </SettingsSection>
+  );
+}

package/src/settings/projectVMobileApps.ts

@@ -0,0 +1,145 @@
+import { familyApp } from "../brand/familyApps";
+
+/** The Project V phone apps, in display order. */
+export type ProjectVMobileAppId = "vibot" | "verve" | "velth" | "vmem" | "vstore";
+
+export type ProjectVMobileApp = {
+  id: ProjectVMobileAppId;
+  /** Display name. */
+  name: string;
+  /** One line for a settings row. */
+  description: string;
+  /** Android application id. */
+  androidPackage: string;
+  /** The app's URL scheme, without `://`. */
+  scheme: string;
+  /** Home page of the app: the fallback when neither the app nor V Store is installed. */
+  website: string;
+};
+
+/**
+ * V Store's home screen. V Store's `app/[id]` route takes the app's Convex
+ * document `_id`, not its catalog id or Android package, and native-ui cannot
+ * know live Convex ids. So the store step opens V Store's home, not the app's page.
+ */
+export const VSTORE_HOME_URL = "vstore://";
+
+// Names and sites come from `FAMILY_APPS` where it has the app. V Store is not
+// a family app there (that file is a byte-identical copy of `@vvedantb/ui`).
+const vibot = familyApp("vibot");
+const verve = familyApp("verve");
+const velth = familyApp("velth");
+const vmem = familyApp("vmem");
+
+/** The five Project V phone apps, in display order. */
+export const PROJECT_V_MOBILE_APPS: readonly ProjectVMobileApp[] = [
+  {
+    id: "vibot",
+    name: vibot.name,
+    description: "AI chat, agents and tools",
+    androidPackage: "com.projectvdotuk.vibot",
+    scheme: "vibot",
+    website: vibot.url,
+  },
+  {
+    id: "verve",
+    name: verve.name,
+    description: "Notes, pages and writing",
+    androidPackage: "com.projectvdotuk.verve",
+    scheme: "verve",
+    website: verve.url,
+  },
+  {
+    id: "velth",
+    name: velth.name,
+    description: "Health insights and camera scans",
+    androidPackage: "com.projectvdotuk.velth",
+    scheme: "velth",
+    website: velth.url,
+  },
+  {
+    id: "vmem",
+    name: vmem.name,
+    description: "Your personal memory",
+    androidPackage: "com.projectvdotuk.vmem",
+    scheme: "vmem",
+    website: vmem.url,
+  },
+  {
+    id: "vstore",
+    name: "V Store",
+    description: "Install Project V apps",
+    androidPackage: "com.projectvdotuk.vstore",
+    scheme: "vstore",
+    website: "https://v-store-chi.vercel.app",
+  },
+];
+
+/** Entry of `PROJECT_V_MOBILE_APPS` for an app. */
+export function projectVMobileApp(id: ProjectVMobileAppId): ProjectVMobileApp {
+  return PROJECT_V_MOBILE_APPS.find((app) => app.id === id)!;
+}
+
+/** The phone apps other than `current`, in display order. */
+export function otherProjectVMobileApps(current?: ProjectVMobileAppId): ProjectVMobileApp[] {
+  return PROJECT_V_MOBILE_APPS.filter((app) => app.id !== current);
+}
+
+/** Android intent URL that opens the installed app with this package. */
+export function androidIntentUrl(app: ProjectVMobileApp): string {
+  return `intent://#Intent;scheme=${app.scheme};package=${app.androidPackage};end`;
+}
+
+/** How `openProjectVApp` opened an app. */
+export type ProjectVOpenTarget = "app" | "store" | "website";
+
+/** One URL to try, in order. `check`: ask `canOpenURL` first; otherwise try `openURL` and move on if it fails. */
+export type ProjectVOpenStep = {
+  target: ProjectVOpenTarget;
+  url: string;
+  check: boolean;
+};
+
+/**
+ * The URLs `openProjectVApp` tries, in order: the app's scheme; on Android an
+ * intent to its package; V Store's home (`VSTORE_HOME_URL`); the website.
+ */
+export function projectVAppOpenSteps(id: ProjectVMobileAppId, os: string): ProjectVOpenStep[] {
+  const app = projectVMobileApp(id);
+  const steps: ProjectVOpenStep[] = [{ target: "app", url: `${app.scheme}://`, check: true }];
+  if (os === "android") steps.push({ target: "app", url: androidIntentUrl(app), check: false });
+  if (id !== "vstore") steps.push({ target: "store", url: VSTORE_HOME_URL, check: true });
+  steps.push({ target: "website", url: app.website, check: false });
+  return steps;
+}
+
+/** The part of React Native `Linking` that `openProjectVApp` uses. */
+export type ProjectVLinking = {
+  canOpenURL(url: string): Promise<boolean>;
+  openURL(url: string): Promise<unknown>;
+};
+
+/**
+ * Opens a Project V app: the app if installed, else V Store's home if V Store
+ * is installed, else its website. Resolves to what it opened, or
+ * `null` when every URL failed. Pass React Native `Linking` and `Platform.OS`.
+ *
+ * `canOpenURL` needs the schemes declared by the calling app:
+ * `LSApplicationQueriesSchemes` on iOS and `<queries>` on Android 11+.
+ */
+export async function openProjectVApp(
+  id: ProjectVMobileAppId,
+  linking: ProjectVLinking,
+  os: string,
+): Promise<ProjectVOpenTarget | null> {
+  for (const step of projectVAppOpenSteps(id, os)) {
+    try {
+      if (step.check && !(await linking.canOpenURL(step.url))) continue;
+      await linking.openURL(step.url);
+      return step.target;
+    } catch {
+      // Not installed, or no handler: try the next URL.
+    }
+  }
+  return null;
+}