@calo-design/cli 0.12.2 → 0.12.4

package/bin/mirror-push.js

@@ -404,6 +404,7 @@ export default function RootLayout() {
   }
   fs.writeFileSync(path.join(stagedAppDir, "_layout.tsx"), managed);
   fs.writeFileSync(path.join(mirrorChromeDir, "mirror-chrome.tsx"), mirrorChromeSource({ slug, owner }));
+  fs.writeFileSync(path.join(mirrorChromeDir, "mirror-escape.tsx"), mirrorEscapeSource());
   injectNativeIntent(stagedAppDir, mirrorChromeDir, slug);
 }
 
@@ -522,15 +523,23 @@ function channelForRef(ref: string): { channel: string; viaLauncher: boolean } {
 // context created later (e.g. by a feed tap, which carries no URL) can't
 // replay it as a phantom switch. Exception: a ref we bounce to the launcher
 // stays in the store on purpose — the launcher consumes (and clears) it.
+//
+// NO slug-based self no-op: with version pinning, one slug spans MANY channels
+// (head + every pinned version), and this same bundle serves several of them —
+// so "slug === PROTOTYPE" cannot mean "already here". A plain self-link now
+// switches to the HEAD channel (the escape hatch out of a pinned version; from
+// the head it's a redundant refresh-to-latest, which is harmless and even
+// useful). Ping-pong protection comes from the handle-once clearing + the
+// switching latch, not from slug comparison.
 function sweepLinkingURL(): void {
   let url: string | null = null;
   try { url = ExpoLinking.getLinkingURL() ?? null; } catch { return; }
   if (!url) return;
   const slug = launcherSlug(url);
   if (slug === null) return; // the prototype's own deep link — not ours to touch
-  if (!slug || slug === PROTOTYPE) {
+  if (!slug) {
     try { ExpoLinking.clearInitialURL(); } catch {}
-    return;
+    return; // bare /open — nothing to switch to
   }
   const target = channelForRef(slug);
   if (!target.viaLauncher) {
@@ -539,6 +548,13 @@ function sweepLinkingURL(): void {
   switchToChannel(target.channel);
 }
 
+// Return to the Mirror launcher (its channel is "mirror"). The shell's native
+// shake-to-return exists too, but this JS path works on every binary — it's what
+// the chrome's floating escape control calls.
+export function returnToMirror(): void {
+  switchToChannel("mirror");
+}
+
 export function subscribeLauncherLinks(): { remove: () => void } {
   sweepLinkingURL(); // the URL that created this context (cold link or switch)
   const linkSub = ExpoLinking.addEventListener("url", () => sweepLinkingURL());
@@ -596,13 +612,52 @@ function runtimeHasSentry() {
 // killing the shell. Everything is defensive — on an old shell binary without
 // the Sentry NATIVE module, init falls back to JS-only transport (and the
 // try/catch backstops that), so prototypes never crash BECAUSE of reporting.
+// Floating return-to-launcher control, rendered by BOTH MirrorChrome variants.
+// The shell's native shake-to-return exists too, but this JS escape works on
+// every binary and every OS — a prototype must never be a dead end. Small and
+// translucent on purpose; bottom-left so it never collides with FABs/CTAs that
+// conventionally live bottom-right.
+function mirrorEscapeSource() {
+  return `import { Pressable, Text } from "react-native";
+import { returnToMirror } from "./mirror-switch";
+
+// Managed by calo-design push — the always-available way OUT of a prototype.
+export function MirrorEscape() {
+  return (
+    <Pressable
+      onPress={returnToMirror}
+      accessibilityRole="button"
+      accessibilityLabel="Back to Calo Mirror"
+      hitSlop={10}
+      style={({ pressed }) => ({
+        position: "absolute",
+        left: 12,
+        bottom: 44,
+        width: 38,
+        height: 38,
+        borderRadius: 19,
+        alignItems: "center",
+        justifyContent: "center",
+        backgroundColor: "rgba(17,17,17,0.42)",
+        opacity: pressed ? 0.9 : 0.55,
+        zIndex: 9999,
+        elevation: 9,
+      })}
+    >
+      <Text style={{ color: "#ffffff", fontSize: 17, lineHeight: 20 }}>{"\\u21A9"}</Text>
+    </Pressable>
+  );
+}
+`;
+}
+
 function mirrorChromeSource({ slug, owner }) {
   if (!SENTRY_DSN || !runtimeHasSentry()) {
     return `import { useEffect, type ReactNode } from "react";
+import { View } from "react-native";
 import { subscribeLauncherLinks } from "./mirror-switch";
+import { MirrorEscape } from "./mirror-escape";
 
-// Returning to the Mirror launcher is handled NATIVELY by the shell binary:
-// shake the device (see calo-design-mirror/plugins/withCaloMirrorIos.js).
 // Crash reporting was NOT injected: no Sentry DSN configured or the shared
 // runtime predates @sentry/react-native (run \`calo-design update\`).
 export function MirrorChrome({ children }: { children: ReactNode }) {
@@ -611,13 +666,19 @@ export function MirrorChrome({ children }: { children: ReactNode }) {
     const sub = subscribeLauncherLinks();
     return () => sub.remove();
   }, []);
-  return <>{children}</>;
+  return (
+    <View style={{ flex: 1 }}>
+      {children}
+      <MirrorEscape />
+    </View>
+  );
 }
 `;
   }
   return `import { Component, type ErrorInfo, type ReactNode } from "react";
 import { Pressable, ScrollView, Text, View } from "react-native";
 import { subscribeLauncherLinks } from "./mirror-switch";
+import { MirrorEscape } from "./mirror-escape";
 
 // Injected by \`calo-design push\` — crash reporting for this prototype.
 // Returning to the Mirror launcher stays NATIVE: shake the device.
@@ -662,7 +723,7 @@ export class MirrorChrome extends Component<{ children: ReactNode }, CrashState>
 
   render() {
     const { error } = this.state;
-    if (!error) return <>{this.props.children}</>;
+    if (!error) return <View style={{ flex: 1 }}>{this.props.children}<MirrorEscape /></View>;
     return (
       <View style={{ flex: 1, backgroundColor: "#ffffff", padding: 24, justifyContent: "center", gap: 12 }}>
         <Text style={{ fontSize: 20, fontWeight: "700", color: "#1a1a1a" }}>This prototype crashed</Text>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calo-design/cli",
-  "version": "0.12.2",
+  "version": "0.12.4",
   "description": "One-line setup for Calo design tooling: logs in with your Calo email and installs the calo-design skill + design-system packages. No GitHub account needed.",
   "bin": {
     "calo-design": "bin/cli.js"