feat(react): add lifecyclePlugin and useFocusEffect hook

.changeset/add-lifecycle-plugin.md

@@ -0,0 +1,10 @@
+---
+"@stackflow/plugin-lifecycle": minor
+---
+
+Add lifecyclePlugin and useFocusEffect hook for activity focus/blur lifecycle
+
+- `useFocusEffect(callback)` hook to register per-activity focus/blur callbacks
+- Detection and invocation in plugin `onChanged` (outside React render cycle)
+- `callbackRef` pattern for always-latest callback without `useCallback`
+- Error isolation via `runSafely()` for all user callbacks

extensions/plugin-lifecycle/esbuild.config.js

@@ -0,0 +1,29 @@
+const { context } = require("esbuild");
+const config = require("@stackflow/esbuild-config");
+const pkg = require("./package.json");
+
+const watch = process.argv.includes("--watch");
+const external = Object.keys({
+  ...pkg.dependencies,
+  ...pkg.peerDependencies,
+});
+
+Promise.all([
+  context({
+    ...config({}),
+    format: "cjs",
+    external,
+  }).then((ctx) =>
+    watch ? ctx.watch() : ctx.rebuild().then(() => ctx.dispose()),
+  ),
+  context({
+    ...config({}),
+    format: "esm",
+    outExtension: {
+      ".js": ".mjs",
+    },
+    external,
+  }).then((ctx) =>
+    watch ? ctx.watch() : ctx.rebuild().then(() => ctx.dispose()),
+  ),
+]).catch(() => process.exit(1));

extensions/plugin-lifecycle/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@stackflow/plugin-lifecycle",
+  "version": "0.0.1",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/daangn/stackflow.git",
+    "directory": "extensions/plugin-lifecycle"
+  },
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "yarn build:js && yarn build:dts",
+    "build:dts": "tsc --emitDeclarationOnly",
+    "build:js": "node ./esbuild.config.js",
+    "clean": "rimraf dist",
+    "dev": "yarn build:js --watch && yarn build:dts --watch",
+    "test": "yarn jest",
+    "typecheck": "tsc --noEmit"
+  },
+  "jest": {
+    "testEnvironment": "jsdom",
+    "coveragePathIgnorePatterns": [
+      "index.ts"
+    ],
+    "transform": {
+      "^.+\\.(t|j)sx?$": "@swc/jest"
+    }
+  },
+  "devDependencies": {
+    "@stackflow/config": "^1.2.2",
+    "@stackflow/core": "^1.3.0",
+    "@stackflow/esbuild-config": "^1.0.3",
+    "@stackflow/plugin-renderer-basic": "^1.1.13",
+    "@stackflow/react": "^1.12.0",
+    "@swc/core": "^1.6.6",
+    "@swc/jest": "^0.2.36",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.3.2",
+    "@types/jest": "^29.5.12",
+    "@types/react": "^18.3.3",
+    "esbuild": "^0.27.3",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "rimraf": "^6.1.3",
+    "typescript": "^5.5.3"
+  },
+  "peerDependencies": {
+    "@stackflow/core": "^1.1.0-canary.0",
+    "@stackflow/react": "^1.3.2-canary.0",
+    "react": ">=16.8.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

extensions/plugin-lifecycle/src/index.ts

@@ -0,0 +1,2 @@
+export { lifecyclePlugin } from "./lifecyclePlugin";
+export { useFocusEffect } from "./useFocusEffect";