@next-core/react-runtime 1.8.0 → 1.10.0

package/dist/cjs/index.js

@@ -168,4 +168,48 @@ Object.keys(_useLocation).forEach(function (key) {
     }
   });
 });
+var _useFeatureFlags = require("./useFeatureFlags.js");
+Object.keys(_useFeatureFlags).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useFeatureFlags[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useFeatureFlags[key];
+    }
+  });
+});
+var _useSystemInfo = require("./useSystemInfo.js");
+Object.keys(_useSystemInfo).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useSystemInfo[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useSystemInfo[key];
+    }
+  });
+});
+var _useCheckPermissions = require("./useCheckPermissions.js");
+Object.keys(_useCheckPermissions).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useCheckPermissions[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useCheckPermissions[key];
+    }
+  });
+});
+var _useControlledState = require("./useControlledState.js");
+Object.keys(_useControlledState).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useControlledState[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useControlledState[key];
+    }
+  });
+});
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["_ReactUseBrick","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_useCurrentTheme","_useCurrentApp","_useRecentApps","_useRouteRender","_useProvider","_asyncWrapBrick","_useNavConfig","_useLazyWrapBrick","_usePathParams","_useSearchParams","_useParams","_useHistory","_useAuth","_useLocation"],"sources":["../../src/index.ts"],"sourcesContent":["export * from \"./ReactUseBrick.js\";\nexport * from \"./useCurrentTheme.js\";\nexport * from \"./useCurrentApp.js\";\nexport * from \"./useRecentApps.js\";\nexport * from \"./useRouteRender.js\";\nexport * from \"./useProvider/useProvider.js\";\nexport * from \"./asyncWrapBrick.js\";\nexport * from \"./useNavConfig.js\";\nexport * from \"./useLazyWrapBrick.js\";\nexport * from \"./usePathParams.js\";\nexport * from \"./useSearchParams.js\";\nexport * from \"./useParams.js\";\nexport * from \"./useHistory.js\";\nexport * from \"./useAuth.js\";\nexport * from \"./useLocation.js\";\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"index.js","names":["_ReactUseBrick","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_useCurrentTheme","_useCurrentApp","_useRecentApps","_useRouteRender","_useProvider","_asyncWrapBrick","_useNavConfig","_useLazyWrapBrick","_usePathParams","_useSearchParams","_useParams","_useHistory","_useAuth","_useLocation","_useFeatureFlags","_useSystemInfo","_useCheckPermissions","_useControlledState"],"sources":["../../src/index.ts"],"sourcesContent":["export * from \"./ReactUseBrick.js\";\nexport * from \"./useCurrentTheme.js\";\nexport * from \"./useCurrentApp.js\";\nexport * from \"./useRecentApps.js\";\nexport * from \"./useRouteRender.js\";\nexport * from \"./useProvider/useProvider.js\";\nexport * from \"./asyncWrapBrick.js\";\nexport * from \"./useNavConfig.js\";\nexport * from \"./useLazyWrapBrick.js\";\nexport * from \"./usePathParams.js\";\nexport * from \"./useSearchParams.js\";\nexport * from \"./useParams.js\";\nexport * from \"./useHistory.js\";\nexport * from \"./useAuth.js\";\nexport * from \"./useLocation.js\";\nexport * from \"./useFeatureFlags.js\";\nexport * from \"./useSystemInfo.js\";\nexport * from \"./useCheckPermissions.js\";\nexport * from \"./useControlledState.js\";\n"],"mappings":"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","ignoreList":[]}

package/dist/cjs/useCheckPermissions.js

@@ -0,0 +1,86 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useCheckPermissions = useCheckPermissions;
+var _react = _interopRequireDefault(require("react"));
+var _easyopsRuntime = require("@next-core/easyops-runtime");
+/**
+ * 检查用户权限的 React hooks。
+ *
+ * 此 hook 用于检查当前登录用户是否拥有指定的权限操作。
+ * 权限必须在 storyboard 配置的 `permissionsPreCheck` 中预先声明，
+ * 否则会返回 false 并在控制台输出错误。
+ *
+ * **工作原理：**
+ * - 权限会在路由渲染时自动预检查（通过 `preCheckPermissions`）
+ * - 此 hook 查询已缓存的权限结果（同步操作）
+ * - 管理员用户始终返回 true
+ * - 未登录用户始终返回 false
+ *
+ * **注意事项：**
+ * 1. 权限必须在 `permissionsPreCheck` 中声明
+ * 2. 所有传入的 actions 都必须有权限才返回 true
+ * 3. 权限检查结果会被缓存，避免重复计算
+ *
+ * @param actions - 需要检查的权限操作列表
+ * @returns 是否拥有所有指定的权限
+ *
+ * @example
+ *
+ * ```tsx
+ * // 检查单个权限
+ * function DeleteButton() {
+ *   const canDelete = useCheckPermissions("my-app:user.delete");
+ *
+ *   if (!canDelete) {
+ *     return null;
+ *   }
+ *
+ *   return <button onClick={handleDelete}>Delete</button>;
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 检查多个权限（需要全部拥有）
+ * function AdminPanel() {
+ *   const hasAccess = useCheckPermissions(
+ *     "my-app:admin.read",
+ *     "my-app:admin.write"
+ *   );
+ *
+ *   if (!hasAccess) {
+ *     return <div>Access Denied</div>;
+ *   }
+ *
+ *   return <div>Admin Panel Content</div>;
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 在 storyboard 中配置权限预检查
+ * // routes.yaml
+ * routes:
+ *   - path: /users
+ *     permissionsPreCheck:
+ *       - "my-app:user.read"
+ *       - "my-app:user.delete"
+ *     bricks:
+ *       - brick: "my-brick"
+ * ```
+ */
+function useCheckPermissions(...actions) {
+  // 使用 useMemo 缓存权限检查结果
+  // 因为权限在会话期间是稳定的，只依赖于 actions 列表
+  return _react.default.useMemo(() => _easyopsRuntime.checkPermissions.checkPermissions(...actions),
+  // 序列化 actions 作为依赖，避免数组引用变化导致重新计算
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  [JSON.stringify(actions)]);
+}
+//# sourceMappingURL=useCheckPermissions.js.map

package/dist/cjs/useCheckPermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCheckPermissions.js","names":["_react","_interopRequireDefault","require","_easyopsRuntime","useCheckPermissions","actions","React","useMemo","checkPermissions","JSON","stringify"],"sources":["../../src/useCheckPermissions.ts"],"sourcesContent":["import React from \"react\";\nimport { checkPermissions } from \"@next-core/easyops-runtime\";\n\n/**\n * 检查用户权限的 React hooks。\n *\n * 此 hook 用于检查当前登录用户是否拥有指定的权限操作。\n * 权限必须在 storyboard 配置的 `permissionsPreCheck` 中预先声明，\n * 否则会返回 false 并在控制台输出错误。\n *\n * **工作原理：**\n * - 权限会在路由渲染时自动预检查（通过 `preCheckPermissions`）\n * - 此 hook 查询已缓存的权限结果（同步操作）\n * - 管理员用户始终返回 true\n * - 未登录用户始终返回 false\n *\n * **注意事项：**\n * 1. 权限必须在 `permissionsPreCheck` 中声明\n * 2. 所有传入的 actions 都必须有权限才返回 true\n * 3. 权限检查结果会被缓存，避免重复计算\n *\n * @param actions - 需要检查的权限操作列表\n * @returns 是否拥有所有指定的权限\n *\n * @example\n *\n * ```tsx\n * // 检查单个权限\n * function DeleteButton() {\n *   const canDelete = useCheckPermissions(\"my-app:user.delete\");\n *\n *   if (!canDelete) {\n *     return null;\n *   }\n *\n *   return <button onClick={handleDelete}>Delete</button>;\n * }\n * ```\n *\n * @example\n *\n * ```tsx\n * // 检查多个权限（需要全部拥有）\n * function AdminPanel() {\n *   const hasAccess = useCheckPermissions(\n *     \"my-app:admin.read\",\n *     \"my-app:admin.write\"\n *   );\n *\n *   if (!hasAccess) {\n *     return <div>Access Denied</div>;\n *   }\n *\n *   return <div>Admin Panel Content</div>;\n * }\n * ```\n *\n * @example\n *\n * ```tsx\n * // 在 storyboard 中配置权限预检查\n * // routes.yaml\n * routes:\n *   - path: /users\n *     permissionsPreCheck:\n *       - \"my-app:user.read\"\n *       - \"my-app:user.delete\"\n *     bricks:\n *       - brick: \"my-brick\"\n * ```\n */\nexport function useCheckPermissions(...actions: string[]): boolean {\n  // 使用 useMemo 缓存权限检查结果\n  // 因为权限在会话期间是稳定的，只依赖于 actions 列表\n  return React.useMemo(\n    () => checkPermissions.checkPermissions(...actions),\n    // 序列化 actions 作为依赖，避免数组引用变化导致重新计算\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [JSON.stringify(actions)]\n  );\n}\n"],"mappings":";;;;;;;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,eAAA,GAAAD,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,mBAAmBA,CAAC,GAAGC,OAAiB,EAAW;EACjE;EACA;EACA,OAAOC,cAAK,CAACC,OAAO,CAClB,MAAMC,gCAAgB,CAACA,gBAAgB,CAAC,GAAGH,OAAO,CAAC;EACnD;EACA;EACA,CAACI,IAAI,CAACC,SAAS,CAACL,OAAO,CAAC,CAC1B,CAAC;AACH","ignoreList":[]}

package/dist/cjs/useControlledState.js

@@ -0,0 +1,144 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useControlledState = useControlledState;
+var _react = _interopRequireDefault(require("react"));
+var _lodash = require("lodash");
+/**
+ * 受控/非受控混合模式的通用 Hook。
+ *
+ * 此 hook 允许组件既支持受控模式(由父组件通过 props 控制状态),
+ * 也支持非受控模式(组件自己管理内部状态)。
+ *
+ * **工作原理:**
+ * - 当 `propValue !== undefined` 时,组件处于**受控模式**,状态跟随 prop 更新
+ * - 当 `propValue === undefined` 时,组件处于**非受控模式**,使用内部状态
+ * - 支持深度比较选项,避免复杂对象引用变化导致的不必要更新
+ *
+ * **使用场景:**
+ * 1. 表单组件需要支持受控和非受控两种模式
+ * 2. 组件状态可能由父组件控制,也可能自己管理
+ * 3. 复杂对象状态需要避免不必要的重新渲染
+ *
+ * @template T - 状态值的类型
+ * @param propValue - 来自 props 的值(undefined 表示非受控模式)
+ * @param defaultValue - 默认值(props 为 undefined 时使用)
+ * @param deepCompare - 是否使用深度比较(用于复杂对象,默认 false)
+ * @returns 返回 [当前值, 设置值的函数],类似 useState
+ *
+ * @example
+ *
+ * ```tsx
+ * // 简单值(字符串、数字)
+ * function MyComponent({ deployed }: { deployed?: string }) {
+ *   const [value, setValue] = useControlledState(deployed, 'host');
+ *
+ *   return (
+ *     <select value={value} onChange={(e) => setValue(e.target.value)}>
+ *       <option value="host">Host</option>
+ *       <option value="container">Container</option>
+ *     </select>
+ *   );
+ * }
+ *
+ * // 使用方式 1:受控模式
+ * <MyComponent deployed="container" />
+ *
+ * // 使用方式 2:非受控模式
+ * <MyComponent />
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 复杂对象(启用深度比较)
+ * interface Config {
+ *   host: string;
+ *   port: number;
+ * }
+ *
+ * function ConfigEditor({ config }: { config?: Config }) {
+ *   const [value, setValue] = useControlledState<Config | null>(
+ *     config,
+ *     null,
+ *     true // 启用深度比较
+ *   );
+ *
+ *   return <div>{JSON.stringify(value)}</div>;
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 与 onChange 回调结合
+ * function Input({
+ *   value,
+ *   defaultValue = '',
+ *   onChange
+ * }: {
+ *   value?: string;
+ *   defaultValue?: string;
+ *   onChange?: (val: string) => void;
+ * }) {
+ *   const [internalValue, setInternalValue] = useControlledState(
+ *     value,
+ *     defaultValue
+ *   );
+ *
+ *   const handleChange = (newValue: string) => {
+ *     setInternalValue(newValue);
+ *     onChange?.(newValue);
+ *   };
+ *
+ *   return (
+ *     <input
+ *       value={internalValue}
+ *       onChange={(e) => handleChange(e.target.value)}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+function useControlledState(propValue, defaultValue, deepCompare = false) {
+  // 初始化内部状态
+  // 如果 propValue 不是 undefined,使用 propValue;否则使用 defaultValue
+  const [internalValue, setInternalValue] = _react.default.useState(propValue !== undefined ? propValue : defaultValue);
+  const isControlled = propValue !== undefined;
+
+  // 在受控模式下同步 propValue 到 internalValue
+  _react.default.useEffect(() => {
+    if (isControlled) {
+      if (deepCompare) {
+        // 深度比较模式:只有值真正变化时才更新
+        setInternalValue(prev => (0, _lodash.isEqual)(prev, propValue) ? prev : propValue);
+      } else {
+        // 浅比较模式:直接更新(React 会自动优化相同值)
+        setInternalValue(propValue);
+      }
+    }
+    // 注意:当 propValue 变为 undefined 时,不更新 internalValue
+    // 这样可以保持最后一次的值,实现从受控切换到非受控的平滑过渡
+  }, [isControlled, propValue, deepCompare]);
+
+  // 计算最终返回的值
+  let value;
+  if (isControlled) {
+    if (deepCompare) {
+      // 深度比较模式:如果内容相同,返回 internalValue 保持引用稳定
+      // 否则返回 propValue
+      value = (0, _lodash.isEqual)(internalValue, propValue) ? internalValue : propValue;
+    } else {
+      // 浅比较模式:直接返回 propValue,确保受控模式下值始终同步
+      value = propValue;
+    }
+  } else {
+    // 非受控模式:返回 internalValue
+    value = internalValue;
+  }
+  return [value, setInternalValue];
+}
+//# sourceMappingURL=useControlledState.js.map

package/dist/cjs/useControlledState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useControlledState.js","names":["_react","_interopRequireDefault","require","_lodash","useControlledState","propValue","defaultValue","deepCompare","internalValue","setInternalValue","React","useState","undefined","isControlled","useEffect","prev","isEqual","value"],"sources":["../../src/useControlledState.ts"],"sourcesContent":["import React from \"react\";\nimport { isEqual } from \"lodash\";\n\n/**\n * 受控/非受控混合模式的通用 Hook。\n *\n * 此 hook 允许组件既支持受控模式(由父组件通过 props 控制状态),\n * 也支持非受控模式(组件自己管理内部状态)。\n *\n * **工作原理:**\n * - 当 `propValue !== undefined` 时,组件处于**受控模式**,状态跟随 prop 更新\n * - 当 `propValue === undefined` 时,组件处于**非受控模式**,使用内部状态\n * - 支持深度比较选项,避免复杂对象引用变化导致的不必要更新\n *\n * **使用场景:**\n * 1. 表单组件需要支持受控和非受控两种模式\n * 2. 组件状态可能由父组件控制,也可能自己管理\n * 3. 复杂对象状态需要避免不必要的重新渲染\n *\n * @template T - 状态值的类型\n * @param propValue - 来自 props 的值(undefined 表示非受控模式)\n * @param defaultValue - 默认值(props 为 undefined 时使用)\n * @param deepCompare - 是否使用深度比较(用于复杂对象,默认 false)\n * @returns 返回 [当前值, 设置值的函数],类似 useState\n *\n * @example\n *\n * ```tsx\n * // 简单值(字符串、数字)\n * function MyComponent({ deployed }: { deployed?: string }) {\n *   const [value, setValue] = useControlledState(deployed, 'host');\n *\n *   return (\n *     <select value={value} onChange={(e) => setValue(e.target.value)}>\n *       <option value=\"host\">Host</option>\n *       <option value=\"container\">Container</option>\n *     </select>\n *   );\n * }\n *\n * // 使用方式 1:受控模式\n * <MyComponent deployed=\"container\" />\n *\n * // 使用方式 2:非受控模式\n * <MyComponent />\n * ```\n *\n * @example\n *\n * ```tsx\n * // 复杂对象(启用深度比较)\n * interface Config {\n *   host: string;\n *   port: number;\n * }\n *\n * function ConfigEditor({ config }: { config?: Config }) {\n *   const [value, setValue] = useControlledState<Config | null>(\n *     config,\n *     null,\n *     true // 启用深度比较\n *   );\n *\n *   return <div>{JSON.stringify(value)}</div>;\n * }\n * ```\n *\n * @example\n *\n * ```tsx\n * // 与 onChange 回调结合\n * function Input({\n *   value,\n *   defaultValue = '',\n *   onChange\n * }: {\n *   value?: string;\n *   defaultValue?: string;\n *   onChange?: (val: string) => void;\n * }) {\n *   const [internalValue, setInternalValue] = useControlledState(\n *     value,\n *     defaultValue\n *   );\n *\n *   const handleChange = (newValue: string) => {\n *     setInternalValue(newValue);\n *     onChange?.(newValue);\n *   };\n *\n *   return (\n *     <input\n *       value={internalValue}\n *       onChange={(e) => handleChange(e.target.value)}\n *     />\n *   );\n * }\n * ```\n */\nexport function useControlledState<T>(\n  propValue: T | undefined,\n  defaultValue: T,\n  deepCompare = false\n): [T, React.Dispatch<React.SetStateAction<T>>] {\n  // 初始化内部状态\n  // 如果 propValue 不是 undefined,使用 propValue;否则使用 defaultValue\n  const [internalValue, setInternalValue] = React.useState<T>(\n    propValue !== undefined ? propValue : defaultValue\n  );\n\n  const isControlled = propValue !== undefined;\n\n  // 在受控模式下同步 propValue 到 internalValue\n  React.useEffect(() => {\n    if (isControlled) {\n      if (deepCompare) {\n        // 深度比较模式:只有值真正变化时才更新\n        setInternalValue((prev) =>\n          isEqual(prev, propValue) ? prev : propValue\n        );\n      } else {\n        // 浅比较模式:直接更新(React 会自动优化相同值)\n        setInternalValue(propValue);\n      }\n    }\n    // 注意:当 propValue 变为 undefined 时,不更新 internalValue\n    // 这样可以保持最后一次的值,实现从受控切换到非受控的平滑过渡\n  }, [isControlled, propValue, deepCompare]);\n\n  // 计算最终返回的值\n  let value: T;\n  if (isControlled) {\n    if (deepCompare) {\n      // 深度比较模式:如果内容相同,返回 internalValue 保持引用稳定\n      // 否则返回 propValue\n      value = isEqual(internalValue, propValue) ? internalValue : propValue;\n    } else {\n      // 浅比较模式:直接返回 propValue,确保受控模式下值始终同步\n      value = propValue;\n    }\n  } else {\n    // 非受控模式:返回 internalValue\n    value = internalValue;\n  }\n\n  return [value, setInternalValue];\n}\n"],"mappings":";;;;;;;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,kBAAkBA,CAChCC,SAAwB,EACxBC,YAAe,EACfC,WAAW,GAAG,KAAK,EAC2B;EAC9C;EACA;EACA,MAAM,CAACC,aAAa,EAAEC,gBAAgB,CAAC,GAAGC,cAAK,CAACC,QAAQ,CACtDN,SAAS,KAAKO,SAAS,GAAGP,SAAS,GAAGC,YACxC,CAAC;EAED,MAAMO,YAAY,GAAGR,SAAS,KAAKO,SAAS;;EAE5C;EACAF,cAAK,CAACI,SAAS,CAAC,MAAM;IACpB,IAAID,YAAY,EAAE;MAChB,IAAIN,WAAW,EAAE;QACf;QACAE,gBAAgB,CAAEM,IAAI,IACpB,IAAAC,eAAO,EAACD,IAAI,EAAEV,SAAS,CAAC,GAAGU,IAAI,GAAGV,SACpC,CAAC;MACH,CAAC,MAAM;QACL;QACAI,gBAAgB,CAACJ,SAAS,CAAC;MAC7B;IACF;IACA;IACA;EACF,CAAC,EAAE,CAACQ,YAAY,EAAER,SAAS,EAAEE,WAAW,CAAC,CAAC;;EAE1C;EACA,IAAIU,KAAQ;EACZ,IAAIJ,YAAY,EAAE;IAChB,IAAIN,WAAW,EAAE;MACf;MACA;MACAU,KAAK,GAAG,IAAAD,eAAO,EAACR,aAAa,EAAEH,SAAS,CAAC,GAAGG,aAAa,GAAGH,SAAS;IACvE,CAAC,MAAM;MACL;MACAY,KAAK,GAAGZ,SAAS;IACnB;EACF,CAAC,MAAM;IACL;IACAY,KAAK,GAAGT,aAAa;EACvB;EAEA,OAAO,CAACS,KAAK,EAAER,gBAAgB,CAAC;AAClC","ignoreList":[]}

package/dist/cjs/useFeatureFlags.js

@@ -0,0 +1,51 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useFeatureFlags = useFeatureFlags;
+var _react = _interopRequireDefault(require("react"));
+var _runtime = require("@next-core/runtime");
+/**
+ * 获取特性开关配置的 React hooks。
+ *
+ * 特性开关用于控制功能的启用或禁用，可以在全局设置或应用级别配置。
+ * 使用 useMemo 确保返回的对象引用稳定，避免不必要的组件重渲染。
+ *
+ * @example
+ *
+ * ```tsx
+ * function MyReactComponent() {
+ *   const flags = useFeatureFlags();
+ *
+ *   if (flags["my-new-feature"]) {
+ *     return <NewFeature />;
+ *   }
+ *
+ *   return <OldFeature />;
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 检查特定功能是否启用
+ * function FeatureToggle() {
+ *   const flags = useFeatureFlags();
+ *   const isEnabled = flags["experimental-mode"] ?? false;
+ *
+ *   return (
+ *     <div>
+ *       Experimental Mode: {isEnabled ? "ON" : "OFF"}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @returns 特性开关配置对象，键为特性名称，值为布尔值。
+ */
+function useFeatureFlags() {
+  return _react.default.useMemo(() => (0, _runtime.getRuntime)().getFeatureFlags(), []);
+}
+//# sourceMappingURL=useFeatureFlags.js.map

package/dist/cjs/useFeatureFlags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFeatureFlags.js","names":["_react","_interopRequireDefault","require","_runtime","useFeatureFlags","React","useMemo","getRuntime","getFeatureFlags"],"sources":["../../src/useFeatureFlags.ts"],"sourcesContent":["import React from \"react\";\nimport { getRuntime } from \"@next-core/runtime\";\nimport type { FeatureFlags } from \"@next-core/types\";\n\n/**\n * 获取特性开关配置的 React hooks。\n *\n * 特性开关用于控制功能的启用或禁用，可以在全局设置或应用级别配置。\n * 使用 useMemo 确保返回的对象引用稳定，避免不必要的组件重渲染。\n *\n * @example\n *\n * ```tsx\n * function MyReactComponent() {\n *   const flags = useFeatureFlags();\n *\n *   if (flags[\"my-new-feature\"]) {\n *     return <NewFeature />;\n *   }\n *\n *   return <OldFeature />;\n * }\n * ```\n *\n * @example\n *\n * ```tsx\n * // 检查特定功能是否启用\n * function FeatureToggle() {\n *   const flags = useFeatureFlags();\n *   const isEnabled = flags[\"experimental-mode\"] ?? false;\n *\n *   return (\n *     <div>\n *       Experimental Mode: {isEnabled ? \"ON\" : \"OFF\"}\n *     </div>\n *   );\n * }\n * ```\n *\n * @returns 特性开关配置对象，键为特性名称，值为布尔值。\n */\nexport function useFeatureFlags(): FeatureFlags {\n  return React.useMemo(() => getRuntime().getFeatureFlags(), []);\n}\n"],"mappings":";;;;;;;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,QAAA,GAAAD,OAAA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,eAAeA,CAAA,EAAiB;EAC9C,OAAOC,cAAK,CAACC,OAAO,CAAC,MAAM,IAAAC,mBAAU,EAAC,CAAC,CAACC,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC;AAChE","ignoreList":[]}

package/dist/cjs/useSystemInfo.js

@@ -0,0 +1,74 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useSystemInfo = useSystemInfo;
+var _react = _interopRequireDefault(require("react"));
+var _runtime = require("@next-core/runtime");
+var _easyopsRuntime = require("@next-core/easyops-runtime");
+/**
+ * 系统信息接口，包含认证信息、页面信息和品牌设置。
+ */
+
+/**
+ * 获取系统信息的 React hooks。
+ *
+ * 系统信息包括：
+ * - 用户认证信息（username, userInstanceId, org 等）
+ * - 页面信息（isInIframe, isInIframeOfNext 等）
+ * - 品牌设置（base_title 等）
+ *
+ * **注意**: 使用 useMemo 确保返回的对象引用稳定，
+ * 避免不必要的组件重渲染。系统信息在会话期间保持稳定。
+ *
+ * @example
+ *
+ * ```tsx
+ * function MyReactComponent() {
+ *   const sys = useSystemInfo();
+ *
+ *   return (
+ *     <div>
+ *       <p>User: {sys.username}</p>
+ *       <p>Org: {sys.org}</p>
+ *       <p>In iframe: {sys.isInIframe ? "Yes" : "No"}</p>
+ *       <p>Brand: {sys.settings.brand.base_title}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 检查是否在 iframe 中
+ * function IframeDetector() {
+ *   const sys = useSystemInfo();
+ *
+ *   if (sys.isInIframe) {
+ *     return <div>Running in iframe mode</div>;
+ *   }
+ *
+ *   return <div>Running in standalone mode</div>;
+ * }
+ * ```
+ *
+ * @returns 系统信息对象。
+ */
+function useSystemInfo() {
+  return _react.default.useMemo(() => {
+    const authInfo = _easyopsRuntime.auth.getAuth();
+    const pageInfo = (0, _runtime.getPageInfo)();
+    const brandSettings = (0, _runtime.getRuntime)().getBrandSettings();
+    return {
+      ...authInfo,
+      ...pageInfo,
+      settings: {
+        brand: brandSettings
+      }
+    };
+  }, []);
+}
+//# sourceMappingURL=useSystemInfo.js.map

package/dist/cjs/useSystemInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSystemInfo.js","names":["_react","_interopRequireDefault","require","_runtime","_easyopsRuntime","useSystemInfo","React","useMemo","authInfo","auth","getAuth","pageInfo","getPageInfo","brandSettings","getRuntime","getBrandSettings","settings","brand"],"sources":["../../src/useSystemInfo.ts"],"sourcesContent":["import React from \"react\";\nimport { getRuntime, getPageInfo } from \"@next-core/runtime\";\nimport { auth } from \"@next-core/easyops-runtime\";\nimport type { PageInfo } from \"@next-core/runtime\";\n\n/**\n * 系统信息接口，包含认证信息、页面信息和品牌设置。\n */\nexport interface SystemInfo extends PageInfo {\n  /** 用户认证信息 */\n  username?: string;\n  userInstanceId?: string;\n  org?: number;\n  [key: string]: unknown;\n\n  /** 系统设置 */\n  settings: {\n    /** 品牌设置 */\n    brand: Record<string, string>;\n  };\n}\n\n/**\n * 获取系统信息的 React hooks。\n *\n * 系统信息包括：\n * - 用户认证信息（username, userInstanceId, org 等）\n * - 页面信息（isInIframe, isInIframeOfNext 等）\n * - 品牌设置（base_title 等）\n *\n * **注意**: 使用 useMemo 确保返回的对象引用稳定，\n * 避免不必要的组件重渲染。系统信息在会话期间保持稳定。\n *\n * @example\n *\n * ```tsx\n * function MyReactComponent() {\n *   const sys = useSystemInfo();\n *\n *   return (\n *     <div>\n *       <p>User: {sys.username}</p>\n *       <p>Org: {sys.org}</p>\n *       <p>In iframe: {sys.isInIframe ? \"Yes\" : \"No\"}</p>\n *       <p>Brand: {sys.settings.brand.base_title}</p>\n *     </div>\n *   );\n * }\n * ```\n *\n * @example\n *\n * ```tsx\n * // 检查是否在 iframe 中\n * function IframeDetector() {\n *   const sys = useSystemInfo();\n *\n *   if (sys.isInIframe) {\n *     return <div>Running in iframe mode</div>;\n *   }\n *\n *   return <div>Running in standalone mode</div>;\n * }\n * ```\n *\n * @returns 系统信息对象。\n */\nexport function useSystemInfo(): SystemInfo {\n  return React.useMemo(() => {\n    const authInfo = auth.getAuth();\n    const pageInfo = getPageInfo();\n    const brandSettings = getRuntime().getBrandSettings();\n\n    return {\n      ...authInfo,\n      ...pageInfo,\n      settings: {\n        brand: brandSettings,\n      },\n    };\n  }, []);\n}\n"],"mappings":";;;;;;;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,QAAA,GAAAD,OAAA;AACA,IAAAE,eAAA,GAAAF,OAAA;AAGA;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,aAAaA,CAAA,EAAe;EAC1C,OAAOC,cAAK,CAACC,OAAO,CAAC,MAAM;IACzB,MAAMC,QAAQ,GAAGC,oBAAI,CAACC,OAAO,CAAC,CAAC;IAC/B,MAAMC,QAAQ,GAAG,IAAAC,oBAAW,EAAC,CAAC;IAC9B,MAAMC,aAAa,GAAG,IAAAC,mBAAU,EAAC,CAAC,CAACC,gBAAgB,CAAC,CAAC;IAErD,OAAO;MACL,GAAGP,QAAQ;MACX,GAAGG,QAAQ;MACXK,QAAQ,EAAE;QACRC,KAAK,EAAEJ;MACT;IACF,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;AACR","ignoreList":[]}

package/dist/esm/index.js

@@ -13,4 +13,8 @@ export * from "./useParams.js";
 export * from "./useHistory.js";
 export * from "./useAuth.js";
 export * from "./useLocation.js";
+export * from "./useFeatureFlags.js";
+export * from "./useSystemInfo.js";
+export * from "./useCheckPermissions.js";
+export * from "./useControlledState.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/index.ts"],"sourcesContent":["export * from \"./ReactUseBrick.js\";\nexport * from \"./useCurrentTheme.js\";\nexport * from \"./useCurrentApp.js\";\nexport * from \"./useRecentApps.js\";\nexport * from \"./useRouteRender.js\";\nexport * from \"./useProvider/useProvider.js\";\nexport * from \"./asyncWrapBrick.js\";\nexport * from \"./useNavConfig.js\";\nexport * from \"./useLazyWrapBrick.js\";\nexport * from \"./usePathParams.js\";\nexport * from \"./useSearchParams.js\";\nexport * from \"./useParams.js\";\nexport * from \"./useHistory.js\";\nexport * from \"./useAuth.js\";\nexport * from \"./useLocation.js\";\n"],"mappings":"AAAA,cAAc,oBAAoB;AAClC,cAAc,sBAAsB;AACpC,cAAc,oBAAoB;AAClC,cAAc,oBAAoB;AAClC,cAAc,qBAAqB;AACnC,cAAc,8BAA8B;AAC5C,cAAc,qBAAqB;AACnC,cAAc,mBAAmB;AACjC,cAAc,uBAAuB;AACrC,cAAc,oBAAoB;AAClC,cAAc,sBAAsB;AACpC,cAAc,gBAAgB;AAC9B,cAAc,iBAAiB;AAC/B,cAAc,cAAc;AAC5B,cAAc,kBAAkB","ignoreList":[]}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/index.ts"],"sourcesContent":["export * from \"./ReactUseBrick.js\";\nexport * from \"./useCurrentTheme.js\";\nexport * from \"./useCurrentApp.js\";\nexport * from \"./useRecentApps.js\";\nexport * from \"./useRouteRender.js\";\nexport * from \"./useProvider/useProvider.js\";\nexport * from \"./asyncWrapBrick.js\";\nexport * from \"./useNavConfig.js\";\nexport * from \"./useLazyWrapBrick.js\";\nexport * from \"./usePathParams.js\";\nexport * from \"./useSearchParams.js\";\nexport * from \"./useParams.js\";\nexport * from \"./useHistory.js\";\nexport * from \"./useAuth.js\";\nexport * from \"./useLocation.js\";\nexport * from \"./useFeatureFlags.js\";\nexport * from \"./useSystemInfo.js\";\nexport * from \"./useCheckPermissions.js\";\nexport * from \"./useControlledState.js\";\n"],"mappings":"AAAA,cAAc,oBAAoB;AAClC,cAAc,sBAAsB;AACpC,cAAc,oBAAoB;AAClC,cAAc,oBAAoB;AAClC,cAAc,qBAAqB;AACnC,cAAc,8BAA8B;AAC5C,cAAc,qBAAqB;AACnC,cAAc,mBAAmB;AACjC,cAAc,uBAAuB;AACrC,cAAc,oBAAoB;AAClC,cAAc,sBAAsB;AACpC,cAAc,gBAAgB;AAC9B,cAAc,iBAAiB;AAC/B,cAAc,cAAc;AAC5B,cAAc,kBAAkB;AAChC,cAAc,sBAAsB;AACpC,cAAc,oBAAoB;AAClC,cAAc,0BAA0B;AACxC,cAAc,yBAAyB","ignoreList":[]}

package/dist/esm/useCheckPermissions.js

@@ -0,0 +1,83 @@
+import React from "react";
+import { checkPermissions } from "@next-core/easyops-runtime";
+
+/**
+ * 检查用户权限的 React hooks。
+ *
+ * 此 hook 用于检查当前登录用户是否拥有指定的权限操作。
+ * 权限必须在 storyboard 配置的 `permissionsPreCheck` 中预先声明，
+ * 否则会返回 false 并在控制台输出错误。
+ *
+ * **工作原理：**
+ * - 权限会在路由渲染时自动预检查（通过 `preCheckPermissions`）
+ * - 此 hook 查询已缓存的权限结果（同步操作）
+ * - 管理员用户始终返回 true
+ * - 未登录用户始终返回 false
+ *
+ * **注意事项：**
+ * 1. 权限必须在 `permissionsPreCheck` 中声明
+ * 2. 所有传入的 actions 都必须有权限才返回 true
+ * 3. 权限检查结果会被缓存，避免重复计算
+ *
+ * @param actions - 需要检查的权限操作列表
+ * @returns 是否拥有所有指定的权限
+ *
+ * @example
+ *
+ * ```tsx
+ * // 检查单个权限
+ * function DeleteButton() {
+ *   const canDelete = useCheckPermissions("my-app:user.delete");
+ *
+ *   if (!canDelete) {
+ *     return null;
+ *   }
+ *
+ *   return <button onClick={handleDelete}>Delete</button>;
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 检查多个权限（需要全部拥有）
+ * function AdminPanel() {
+ *   const hasAccess = useCheckPermissions(
+ *     "my-app:admin.read",
+ *     "my-app:admin.write"
+ *   );
+ *
+ *   if (!hasAccess) {
+ *     return <div>Access Denied</div>;
+ *   }
+ *
+ *   return <div>Admin Panel Content</div>;
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 在 storyboard 中配置权限预检查
+ * // routes.yaml
+ * routes:
+ *   - path: /users
+ *     permissionsPreCheck:
+ *       - "my-app:user.read"
+ *       - "my-app:user.delete"
+ *     bricks:
+ *       - brick: "my-brick"
+ * ```
+ */
+export function useCheckPermissions() {
+  for (var _len = arguments.length, actions = new Array(_len), _key = 0; _key < _len; _key++) {
+    actions[_key] = arguments[_key];
+  }
+  // 使用 useMemo 缓存权限检查结果
+  // 因为权限在会话期间是稳定的，只依赖于 actions 列表
+  return React.useMemo(() => checkPermissions.checkPermissions(...actions),
+  // 序列化 actions 作为依赖，避免数组引用变化导致重新计算
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  [JSON.stringify(actions)]);
+}
+//# sourceMappingURL=useCheckPermissions.js.map

package/dist/esm/useCheckPermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCheckPermissions.js","names":["React","checkPermissions","useCheckPermissions","_len","arguments","length","actions","Array","_key","useMemo","JSON","stringify"],"sources":["../../src/useCheckPermissions.ts"],"sourcesContent":["import React from \"react\";\nimport { checkPermissions } from \"@next-core/easyops-runtime\";\n\n/**\n * 检查用户权限的 React hooks。\n *\n * 此 hook 用于检查当前登录用户是否拥有指定的权限操作。\n * 权限必须在 storyboard 配置的 `permissionsPreCheck` 中预先声明，\n * 否则会返回 false 并在控制台输出错误。\n *\n * **工作原理：**\n * - 权限会在路由渲染时自动预检查（通过 `preCheckPermissions`）\n * - 此 hook 查询已缓存的权限结果（同步操作）\n * - 管理员用户始终返回 true\n * - 未登录用户始终返回 false\n *\n * **注意事项：**\n * 1. 权限必须在 `permissionsPreCheck` 中声明\n * 2. 所有传入的 actions 都必须有权限才返回 true\n * 3. 权限检查结果会被缓存，避免重复计算\n *\n * @param actions - 需要检查的权限操作列表\n * @returns 是否拥有所有指定的权限\n *\n * @example\n *\n * ```tsx\n * // 检查单个权限\n * function DeleteButton() {\n *   const canDelete = useCheckPermissions(\"my-app:user.delete\");\n *\n *   if (!canDelete) {\n *     return null;\n *   }\n *\n *   return <button onClick={handleDelete}>Delete</button>;\n * }\n * ```\n *\n * @example\n *\n * ```tsx\n * // 检查多个权限（需要全部拥有）\n * function AdminPanel() {\n *   const hasAccess = useCheckPermissions(\n *     \"my-app:admin.read\",\n *     \"my-app:admin.write\"\n *   );\n *\n *   if (!hasAccess) {\n *     return <div>Access Denied</div>;\n *   }\n *\n *   return <div>Admin Panel Content</div>;\n * }\n * ```\n *\n * @example\n *\n * ```tsx\n * // 在 storyboard 中配置权限预检查\n * // routes.yaml\n * routes:\n *   - path: /users\n *     permissionsPreCheck:\n *       - \"my-app:user.read\"\n *       - \"my-app:user.delete\"\n *     bricks:\n *       - brick: \"my-brick\"\n * ```\n */\nexport function useCheckPermissions(...actions: string[]): boolean {\n  // 使用 useMemo 缓存权限检查结果\n  // 因为权限在会话期间是稳定的，只依赖于 actions 列表\n  return React.useMemo(\n    () => checkPermissions.checkPermissions(...actions),\n    // 序列化 actions 作为依赖，避免数组引用变化导致重新计算\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [JSON.stringify(actions)]\n  );\n}\n"],"mappings":"AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,gBAAgB,QAAQ,4BAA4B;;AAE7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAAA,EAAgC;EAAA,SAAAC,IAAA,GAAAC,SAAA,CAAAC,MAAA,EAA5BC,OAAO,OAAAC,KAAA,CAAAJ,IAAA,GAAAK,IAAA,MAAAA,IAAA,GAAAL,IAAA,EAAAK,IAAA;IAAPF,OAAO,CAAAE,IAAA,IAAAJ,SAAA,CAAAI,IAAA;EAAA;EAC5C;EACA;EACA,OAAOR,KAAK,CAACS,OAAO,CAClB,MAAMR,gBAAgB,CAACA,gBAAgB,CAAC,GAAGK,OAAO,CAAC;EACnD;EACA;EACA,CAACI,IAAI,CAACC,SAAS,CAACL,OAAO,CAAC,CAC1B,CAAC;AACH","ignoreList":[]}

package/dist/esm/useControlledState.js

@@ -0,0 +1,139 @@
+import React from "react";
+import { isEqual } from "lodash";
+
+/**
+ * 受控/非受控混合模式的通用 Hook。
+ *
+ * 此 hook 允许组件既支持受控模式(由父组件通过 props 控制状态),
+ * 也支持非受控模式(组件自己管理内部状态)。
+ *
+ * **工作原理:**
+ * - 当 `propValue !== undefined` 时,组件处于**受控模式**,状态跟随 prop 更新
+ * - 当 `propValue === undefined` 时,组件处于**非受控模式**,使用内部状态
+ * - 支持深度比较选项,避免复杂对象引用变化导致的不必要更新
+ *
+ * **使用场景:**
+ * 1. 表单组件需要支持受控和非受控两种模式
+ * 2. 组件状态可能由父组件控制,也可能自己管理
+ * 3. 复杂对象状态需要避免不必要的重新渲染
+ *
+ * @template T - 状态值的类型
+ * @param propValue - 来自 props 的值(undefined 表示非受控模式)
+ * @param defaultValue - 默认值(props 为 undefined 时使用)
+ * @param deepCompare - 是否使用深度比较(用于复杂对象,默认 false)
+ * @returns 返回 [当前值, 设置值的函数],类似 useState
+ *
+ * @example
+ *
+ * ```tsx
+ * // 简单值(字符串、数字)
+ * function MyComponent({ deployed }: { deployed?: string }) {
+ *   const [value, setValue] = useControlledState(deployed, 'host');
+ *
+ *   return (
+ *     <select value={value} onChange={(e) => setValue(e.target.value)}>
+ *       <option value="host">Host</option>
+ *       <option value="container">Container</option>
+ *     </select>
+ *   );
+ * }
+ *
+ * // 使用方式 1:受控模式
+ * <MyComponent deployed="container" />
+ *
+ * // 使用方式 2:非受控模式
+ * <MyComponent />
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 复杂对象(启用深度比较)
+ * interface Config {
+ *   host: string;
+ *   port: number;
+ * }
+ *
+ * function ConfigEditor({ config }: { config?: Config }) {
+ *   const [value, setValue] = useControlledState<Config | null>(
+ *     config,
+ *     null,
+ *     true // 启用深度比较
+ *   );
+ *
+ *   return <div>{JSON.stringify(value)}</div>;
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 与 onChange 回调结合
+ * function Input({
+ *   value,
+ *   defaultValue = '',
+ *   onChange
+ * }: {
+ *   value?: string;
+ *   defaultValue?: string;
+ *   onChange?: (val: string) => void;
+ * }) {
+ *   const [internalValue, setInternalValue] = useControlledState(
+ *     value,
+ *     defaultValue
+ *   );
+ *
+ *   const handleChange = (newValue: string) => {
+ *     setInternalValue(newValue);
+ *     onChange?.(newValue);
+ *   };
+ *
+ *   return (
+ *     <input
+ *       value={internalValue}
+ *       onChange={(e) => handleChange(e.target.value)}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export function useControlledState(propValue, defaultValue) {
+  let deepCompare = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+  // 初始化内部状态
+  // 如果 propValue 不是 undefined,使用 propValue;否则使用 defaultValue
+  const [internalValue, setInternalValue] = React.useState(propValue !== undefined ? propValue : defaultValue);
+  const isControlled = propValue !== undefined;
+
+  // 在受控模式下同步 propValue 到 internalValue
+  React.useEffect(() => {
+    if (isControlled) {
+      if (deepCompare) {
+        // 深度比较模式:只有值真正变化时才更新
+        setInternalValue(prev => isEqual(prev, propValue) ? prev : propValue);
+      } else {
+        // 浅比较模式:直接更新(React 会自动优化相同值)
+        setInternalValue(propValue);
+      }
+    }
+    // 注意:当 propValue 变为 undefined 时,不更新 internalValue
+    // 这样可以保持最后一次的值,实现从受控切换到非受控的平滑过渡
+  }, [isControlled, propValue, deepCompare]);
+
+  // 计算最终返回的值
+  let value;
+  if (isControlled) {
+    if (deepCompare) {
+      // 深度比较模式:如果内容相同,返回 internalValue 保持引用稳定
+      // 否则返回 propValue
+      value = isEqual(internalValue, propValue) ? internalValue : propValue;
+    } else {
+      // 浅比较模式:直接返回 propValue,确保受控模式下值始终同步
+      value = propValue;
+    }
+  } else {
+    // 非受控模式:返回 internalValue
+    value = internalValue;
+  }
+  return [value, setInternalValue];
+}
+//# sourceMappingURL=useControlledState.js.map

package/dist/esm/useControlledState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useControlledState.js","names":["React","isEqual","useControlledState","propValue","defaultValue","deepCompare","arguments","length","undefined","internalValue","setInternalValue","useState","isControlled","useEffect","prev","value"],"sources":["../../src/useControlledState.ts"],"sourcesContent":["import React from \"react\";\nimport { isEqual } from \"lodash\";\n\n/**\n * 受控/非受控混合模式的通用 Hook。\n *\n * 此 hook 允许组件既支持受控模式(由父组件通过 props 控制状态),\n * 也支持非受控模式(组件自己管理内部状态)。\n *\n * **工作原理:**\n * - 当 `propValue !== undefined` 时,组件处于**受控模式**,状态跟随 prop 更新\n * - 当 `propValue === undefined` 时,组件处于**非受控模式**,使用内部状态\n * - 支持深度比较选项,避免复杂对象引用变化导致的不必要更新\n *\n * **使用场景:**\n * 1. 表单组件需要支持受控和非受控两种模式\n * 2. 组件状态可能由父组件控制,也可能自己管理\n * 3. 复杂对象状态需要避免不必要的重新渲染\n *\n * @template T - 状态值的类型\n * @param propValue - 来自 props 的值(undefined 表示非受控模式)\n * @param defaultValue - 默认值(props 为 undefined 时使用)\n * @param deepCompare - 是否使用深度比较(用于复杂对象,默认 false)\n * @returns 返回 [当前值, 设置值的函数],类似 useState\n *\n * @example\n *\n * ```tsx\n * // 简单值(字符串、数字)\n * function MyComponent({ deployed }: { deployed?: string }) {\n *   const [value, setValue] = useControlledState(deployed, 'host');\n *\n *   return (\n *     <select value={value} onChange={(e) => setValue(e.target.value)}>\n *       <option value=\"host\">Host</option>\n *       <option value=\"container\">Container</option>\n *     </select>\n *   );\n * }\n *\n * // 使用方式 1:受控模式\n * <MyComponent deployed=\"container\" />\n *\n * // 使用方式 2:非受控模式\n * <MyComponent />\n * ```\n *\n * @example\n *\n * ```tsx\n * // 复杂对象(启用深度比较)\n * interface Config {\n *   host: string;\n *   port: number;\n * }\n *\n * function ConfigEditor({ config }: { config?: Config }) {\n *   const [value, setValue] = useControlledState<Config | null>(\n *     config,\n *     null,\n *     true // 启用深度比较\n *   );\n *\n *   return <div>{JSON.stringify(value)}</div>;\n * }\n * ```\n *\n * @example\n *\n * ```tsx\n * // 与 onChange 回调结合\n * function Input({\n *   value,\n *   defaultValue = '',\n *   onChange\n * }: {\n *   value?: string;\n *   defaultValue?: string;\n *   onChange?: (val: string) => void;\n * }) {\n *   const [internalValue, setInternalValue] = useControlledState(\n *     value,\n *     defaultValue\n *   );\n *\n *   const handleChange = (newValue: string) => {\n *     setInternalValue(newValue);\n *     onChange?.(newValue);\n *   };\n *\n *   return (\n *     <input\n *       value={internalValue}\n *       onChange={(e) => handleChange(e.target.value)}\n *     />\n *   );\n * }\n * ```\n */\nexport function useControlledState<T>(\n  propValue: T | undefined,\n  defaultValue: T,\n  deepCompare = false\n): [T, React.Dispatch<React.SetStateAction<T>>] {\n  // 初始化内部状态\n  // 如果 propValue 不是 undefined,使用 propValue;否则使用 defaultValue\n  const [internalValue, setInternalValue] = React.useState<T>(\n    propValue !== undefined ? propValue : defaultValue\n  );\n\n  const isControlled = propValue !== undefined;\n\n  // 在受控模式下同步 propValue 到 internalValue\n  React.useEffect(() => {\n    if (isControlled) {\n      if (deepCompare) {\n        // 深度比较模式:只有值真正变化时才更新\n        setInternalValue((prev) =>\n          isEqual(prev, propValue) ? prev : propValue\n        );\n      } else {\n        // 浅比较模式:直接更新(React 会自动优化相同值)\n        setInternalValue(propValue);\n      }\n    }\n    // 注意:当 propValue 变为 undefined 时,不更新 internalValue\n    // 这样可以保持最后一次的值,实现从受控切换到非受控的平滑过渡\n  }, [isControlled, propValue, deepCompare]);\n\n  // 计算最终返回的值\n  let value: T;\n  if (isControlled) {\n    if (deepCompare) {\n      // 深度比较模式:如果内容相同,返回 internalValue 保持引用稳定\n      // 否则返回 propValue\n      value = isEqual(internalValue, propValue) ? internalValue : propValue;\n    } else {\n      // 浅比较模式:直接返回 propValue,确保受控模式下值始终同步\n      value = propValue;\n    }\n  } else {\n    // 非受控模式:返回 internalValue\n    value = internalValue;\n  }\n\n  return [value, setInternalValue];\n}\n"],"mappings":"AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,OAAO,QAAQ,QAAQ;;AAEhC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAChCC,SAAwB,EACxBC,YAAe,EAE+B;EAAA,IAD9CC,WAAW,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,KAAK;EAEnB;EACA;EACA,MAAM,CAACG,aAAa,EAAEC,gBAAgB,CAAC,GAAGV,KAAK,CAACW,QAAQ,CACtDR,SAAS,KAAKK,SAAS,GAAGL,SAAS,GAAGC,YACxC,CAAC;EAED,MAAMQ,YAAY,GAAGT,SAAS,KAAKK,SAAS;;EAE5C;EACAR,KAAK,CAACa,SAAS,CAAC,MAAM;IACpB,IAAID,YAAY,EAAE;MAChB,IAAIP,WAAW,EAAE;QACf;QACAK,gBAAgB,CAAEI,IAAI,IACpBb,OAAO,CAACa,IAAI,EAAEX,SAAS,CAAC,GAAGW,IAAI,GAAGX,SACpC,CAAC;MACH,CAAC,MAAM;QACL;QACAO,gBAAgB,CAACP,SAAS,CAAC;MAC7B;IACF;IACA;IACA;EACF,CAAC,EAAE,CAACS,YAAY,EAAET,SAAS,EAAEE,WAAW,CAAC,CAAC;;EAE1C;EACA,IAAIU,KAAQ;EACZ,IAAIH,YAAY,EAAE;IAChB,IAAIP,WAAW,EAAE;MACf;MACA;MACAU,KAAK,GAAGd,OAAO,CAACQ,aAAa,EAAEN,SAAS,CAAC,GAAGM,aAAa,GAAGN,SAAS;IACvE,CAAC,MAAM;MACL;MACAY,KAAK,GAAGZ,SAAS;IACnB;EACF,CAAC,MAAM;IACL;IACAY,KAAK,GAAGN,aAAa;EACvB;EAEA,OAAO,CAACM,KAAK,EAAEL,gBAAgB,CAAC;AAClC","ignoreList":[]}

package/dist/esm/useFeatureFlags.js

@@ -0,0 +1,44 @@
+import React from "react";
+import { getRuntime } from "@next-core/runtime";
+/**
+ * 获取特性开关配置的 React hooks。
+ *
+ * 特性开关用于控制功能的启用或禁用，可以在全局设置或应用级别配置。
+ * 使用 useMemo 确保返回的对象引用稳定，避免不必要的组件重渲染。
+ *
+ * @example
+ *
+ * ```tsx
+ * function MyReactComponent() {
+ *   const flags = useFeatureFlags();
+ *
+ *   if (flags["my-new-feature"]) {
+ *     return <NewFeature />;
+ *   }
+ *
+ *   return <OldFeature />;
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 检查特定功能是否启用
+ * function FeatureToggle() {
+ *   const flags = useFeatureFlags();
+ *   const isEnabled = flags["experimental-mode"] ?? false;
+ *
+ *   return (
+ *     <div>
+ *       Experimental Mode: {isEnabled ? "ON" : "OFF"}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @returns 特性开关配置对象，键为特性名称，值为布尔值。
+ */
+export function useFeatureFlags() {
+  return React.useMemo(() => getRuntime().getFeatureFlags(), []);
+}
+//# sourceMappingURL=useFeatureFlags.js.map

package/dist/esm/useFeatureFlags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFeatureFlags.js","names":["React","getRuntime","useFeatureFlags","useMemo","getFeatureFlags"],"sources":["../../src/useFeatureFlags.ts"],"sourcesContent":["import React from \"react\";\nimport { getRuntime } from \"@next-core/runtime\";\nimport type { FeatureFlags } from \"@next-core/types\";\n\n/**\n * 获取特性开关配置的 React hooks。\n *\n * 特性开关用于控制功能的启用或禁用，可以在全局设置或应用级别配置。\n * 使用 useMemo 确保返回的对象引用稳定，避免不必要的组件重渲染。\n *\n * @example\n *\n * ```tsx\n * function MyReactComponent() {\n *   const flags = useFeatureFlags();\n *\n *   if (flags[\"my-new-feature\"]) {\n *     return <NewFeature />;\n *   }\n *\n *   return <OldFeature />;\n * }\n * ```\n *\n * @example\n *\n * ```tsx\n * // 检查特定功能是否启用\n * function FeatureToggle() {\n *   const flags = useFeatureFlags();\n *   const isEnabled = flags[\"experimental-mode\"] ?? false;\n *\n *   return (\n *     <div>\n *       Experimental Mode: {isEnabled ? \"ON\" : \"OFF\"}\n *     </div>\n *   );\n * }\n * ```\n *\n * @returns 特性开关配置对象，键为特性名称，值为布尔值。\n */\nexport function useFeatureFlags(): FeatureFlags {\n  return React.useMemo(() => getRuntime().getFeatureFlags(), []);\n}\n"],"mappings":"AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,UAAU,QAAQ,oBAAoB;AAG/C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAAA,EAAiB;EAC9C,OAAOF,KAAK,CAACG,OAAO,CAAC,MAAMF,UAAU,CAAC,CAAC,CAACG,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC;AAChE","ignoreList":[]}

package/dist/esm/useSystemInfo.js

@@ -0,0 +1,68 @@
+import React from "react";
+import { getRuntime, getPageInfo } from "@next-core/runtime";
+import { auth } from "@next-core/easyops-runtime";
+
+/**
+ * 系统信息接口，包含认证信息、页面信息和品牌设置。
+ */
+
+/**
+ * 获取系统信息的 React hooks。
+ *
+ * 系统信息包括：
+ * - 用户认证信息（username, userInstanceId, org 等）
+ * - 页面信息（isInIframe, isInIframeOfNext 等）
+ * - 品牌设置（base_title 等）
+ *
+ * **注意**: 使用 useMemo 确保返回的对象引用稳定，
+ * 避免不必要的组件重渲染。系统信息在会话期间保持稳定。
+ *
+ * @example
+ *
+ * ```tsx
+ * function MyReactComponent() {
+ *   const sys = useSystemInfo();
+ *
+ *   return (
+ *     <div>
+ *       <p>User: {sys.username}</p>
+ *       <p>Org: {sys.org}</p>
+ *       <p>In iframe: {sys.isInIframe ? "Yes" : "No"}</p>
+ *       <p>Brand: {sys.settings.brand.base_title}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 检查是否在 iframe 中
+ * function IframeDetector() {
+ *   const sys = useSystemInfo();
+ *
+ *   if (sys.isInIframe) {
+ *     return <div>Running in iframe mode</div>;
+ *   }
+ *
+ *   return <div>Running in standalone mode</div>;
+ * }
+ * ```
+ *
+ * @returns 系统信息对象。
+ */
+export function useSystemInfo() {
+  return React.useMemo(() => {
+    const authInfo = auth.getAuth();
+    const pageInfo = getPageInfo();
+    const brandSettings = getRuntime().getBrandSettings();
+    return {
+      ...authInfo,
+      ...pageInfo,
+      settings: {
+        brand: brandSettings
+      }
+    };
+  }, []);
+}
+//# sourceMappingURL=useSystemInfo.js.map

package/dist/esm/useSystemInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSystemInfo.js","names":["React","getRuntime","getPageInfo","auth","useSystemInfo","useMemo","authInfo","getAuth","pageInfo","brandSettings","getBrandSettings","settings","brand"],"sources":["../../src/useSystemInfo.ts"],"sourcesContent":["import React from \"react\";\nimport { getRuntime, getPageInfo } from \"@next-core/runtime\";\nimport { auth } from \"@next-core/easyops-runtime\";\nimport type { PageInfo } from \"@next-core/runtime\";\n\n/**\n * 系统信息接口，包含认证信息、页面信息和品牌设置。\n */\nexport interface SystemInfo extends PageInfo {\n  /** 用户认证信息 */\n  username?: string;\n  userInstanceId?: string;\n  org?: number;\n  [key: string]: unknown;\n\n  /** 系统设置 */\n  settings: {\n    /** 品牌设置 */\n    brand: Record<string, string>;\n  };\n}\n\n/**\n * 获取系统信息的 React hooks。\n *\n * 系统信息包括：\n * - 用户认证信息（username, userInstanceId, org 等）\n * - 页面信息（isInIframe, isInIframeOfNext 等）\n * - 品牌设置（base_title 等）\n *\n * **注意**: 使用 useMemo 确保返回的对象引用稳定，\n * 避免不必要的组件重渲染。系统信息在会话期间保持稳定。\n *\n * @example\n *\n * ```tsx\n * function MyReactComponent() {\n *   const sys = useSystemInfo();\n *\n *   return (\n *     <div>\n *       <p>User: {sys.username}</p>\n *       <p>Org: {sys.org}</p>\n *       <p>In iframe: {sys.isInIframe ? \"Yes\" : \"No\"}</p>\n *       <p>Brand: {sys.settings.brand.base_title}</p>\n *     </div>\n *   );\n * }\n * ```\n *\n * @example\n *\n * ```tsx\n * // 检查是否在 iframe 中\n * function IframeDetector() {\n *   const sys = useSystemInfo();\n *\n *   if (sys.isInIframe) {\n *     return <div>Running in iframe mode</div>;\n *   }\n *\n *   return <div>Running in standalone mode</div>;\n * }\n * ```\n *\n * @returns 系统信息对象。\n */\nexport function useSystemInfo(): SystemInfo {\n  return React.useMemo(() => {\n    const authInfo = auth.getAuth();\n    const pageInfo = getPageInfo();\n    const brandSettings = getRuntime().getBrandSettings();\n\n    return {\n      ...authInfo,\n      ...pageInfo,\n      settings: {\n        brand: brandSettings,\n      },\n    };\n  }, []);\n}\n"],"mappings":"AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,UAAU,EAAEC,WAAW,QAAQ,oBAAoB;AAC5D,SAASC,IAAI,QAAQ,4BAA4B;;AAGjD;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAe;EAC1C,OAAOJ,KAAK,CAACK,OAAO,CAAC,MAAM;IACzB,MAAMC,QAAQ,GAAGH,IAAI,CAACI,OAAO,CAAC,CAAC;IAC/B,MAAMC,QAAQ,GAAGN,WAAW,CAAC,CAAC;IAC9B,MAAMO,aAAa,GAAGR,UAAU,CAAC,CAAC,CAACS,gBAAgB,CAAC,CAAC;IAErD,OAAO;MACL,GAAGJ,QAAQ;MACX,GAAGE,QAAQ;MACXG,QAAQ,EAAE;QACRC,KAAK,EAAEH;MACT;IACF,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;AACR","ignoreList":[]}

package/dist/types/index.d.ts

@@ -13,3 +13,7 @@ export * from "./useParams.js";
 export * from "./useHistory.js";
 export * from "./useAuth.js";
 export * from "./useLocation.js";
+export * from "./useFeatureFlags.js";
+export * from "./useSystemInfo.js";
+export * from "./useCheckPermissions.js";
+export * from "./useControlledState.js";

package/dist/types/useCheckPermissions.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 检查用户权限的 React hooks。
+ *
+ * 此 hook 用于检查当前登录用户是否拥有指定的权限操作。
+ * 权限必须在 storyboard 配置的 `permissionsPreCheck` 中预先声明，
+ * 否则会返回 false 并在控制台输出错误。
+ *
+ * **工作原理：**
+ * - 权限会在路由渲染时自动预检查（通过 `preCheckPermissions`）
+ * - 此 hook 查询已缓存的权限结果（同步操作）
+ * - 管理员用户始终返回 true
+ * - 未登录用户始终返回 false
+ *
+ * **注意事项：**
+ * 1. 权限必须在 `permissionsPreCheck` 中声明
+ * 2. 所有传入的 actions 都必须有权限才返回 true
+ * 3. 权限检查结果会被缓存，避免重复计算
+ *
+ * @param actions - 需要检查的权限操作列表
+ * @returns 是否拥有所有指定的权限
+ *
+ * @example
+ *
+ * ```tsx
+ * // 检查单个权限
+ * function DeleteButton() {
+ *   const canDelete = useCheckPermissions("my-app:user.delete");
+ *
+ *   if (!canDelete) {
+ *     return null;
+ *   }
+ *
+ *   return <button onClick={handleDelete}>Delete</button>;
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 检查多个权限（需要全部拥有）
+ * function AdminPanel() {
+ *   const hasAccess = useCheckPermissions(
+ *     "my-app:admin.read",
+ *     "my-app:admin.write"
+ *   );
+ *
+ *   if (!hasAccess) {
+ *     return <div>Access Denied</div>;
+ *   }
+ *
+ *   return <div>Admin Panel Content</div>;
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 在 storyboard 中配置权限预检查
+ * // routes.yaml
+ * routes:
+ *   - path: /users
+ *     permissionsPreCheck:
+ *       - "my-app:user.read"
+ *       - "my-app:user.delete"
+ *     bricks:
+ *       - brick: "my-brick"
+ * ```
+ */
+export declare function useCheckPermissions(...actions: string[]): boolean;

package/dist/types/useControlledState.d.ts

@@ -0,0 +1,98 @@
+import React from "react";
+/**
+ * 受控/非受控混合模式的通用 Hook。
+ *
+ * 此 hook 允许组件既支持受控模式(由父组件通过 props 控制状态),
+ * 也支持非受控模式(组件自己管理内部状态)。
+ *
+ * **工作原理:**
+ * - 当 `propValue !== undefined` 时,组件处于**受控模式**,状态跟随 prop 更新
+ * - 当 `propValue === undefined` 时,组件处于**非受控模式**,使用内部状态
+ * - 支持深度比较选项,避免复杂对象引用变化导致的不必要更新
+ *
+ * **使用场景:**
+ * 1. 表单组件需要支持受控和非受控两种模式
+ * 2. 组件状态可能由父组件控制,也可能自己管理
+ * 3. 复杂对象状态需要避免不必要的重新渲染
+ *
+ * @template T - 状态值的类型
+ * @param propValue - 来自 props 的值(undefined 表示非受控模式)
+ * @param defaultValue - 默认值(props 为 undefined 时使用)
+ * @param deepCompare - 是否使用深度比较(用于复杂对象,默认 false)
+ * @returns 返回 [当前值, 设置值的函数],类似 useState
+ *
+ * @example
+ *
+ * ```tsx
+ * // 简单值(字符串、数字)
+ * function MyComponent({ deployed }: { deployed?: string }) {
+ *   const [value, setValue] = useControlledState(deployed, 'host');
+ *
+ *   return (
+ *     <select value={value} onChange={(e) => setValue(e.target.value)}>
+ *       <option value="host">Host</option>
+ *       <option value="container">Container</option>
+ *     </select>
+ *   );
+ * }
+ *
+ * // 使用方式 1:受控模式
+ * <MyComponent deployed="container" />
+ *
+ * // 使用方式 2:非受控模式
+ * <MyComponent />
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 复杂对象(启用深度比较)
+ * interface Config {
+ *   host: string;
+ *   port: number;
+ * }
+ *
+ * function ConfigEditor({ config }: { config?: Config }) {
+ *   const [value, setValue] = useControlledState<Config | null>(
+ *     config,
+ *     null,
+ *     true // 启用深度比较
+ *   );
+ *
+ *   return <div>{JSON.stringify(value)}</div>;
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 与 onChange 回调结合
+ * function Input({
+ *   value,
+ *   defaultValue = '',
+ *   onChange
+ * }: {
+ *   value?: string;
+ *   defaultValue?: string;
+ *   onChange?: (val: string) => void;
+ * }) {
+ *   const [internalValue, setInternalValue] = useControlledState(
+ *     value,
+ *     defaultValue
+ *   );
+ *
+ *   const handleChange = (newValue: string) => {
+ *     setInternalValue(newValue);
+ *     onChange?.(newValue);
+ *   };
+ *
+ *   return (
+ *     <input
+ *       value={internalValue}
+ *       onChange={(e) => handleChange(e.target.value)}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export declare function useControlledState<T>(propValue: T | undefined, defaultValue: T, deepCompare?: boolean): [T, React.Dispatch<React.SetStateAction<T>>];

package/dist/types/useFeatureFlags.d.ts

@@ -0,0 +1,40 @@
+import type { FeatureFlags } from "@next-core/types";
+/**
+ * 获取特性开关配置的 React hooks。
+ *
+ * 特性开关用于控制功能的启用或禁用，可以在全局设置或应用级别配置。
+ * 使用 useMemo 确保返回的对象引用稳定，避免不必要的组件重渲染。
+ *
+ * @example
+ *
+ * ```tsx
+ * function MyReactComponent() {
+ *   const flags = useFeatureFlags();
+ *
+ *   if (flags["my-new-feature"]) {
+ *     return <NewFeature />;
+ *   }
+ *
+ *   return <OldFeature />;
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 检查特定功能是否启用
+ * function FeatureToggle() {
+ *   const flags = useFeatureFlags();
+ *   const isEnabled = flags["experimental-mode"] ?? false;
+ *
+ *   return (
+ *     <div>
+ *       Experimental Mode: {isEnabled ? "ON" : "OFF"}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @returns 特性开关配置对象，键为特性名称，值为布尔值。
+ */
+export declare function useFeatureFlags(): FeatureFlags;

package/dist/types/useSystemInfo.d.ts

@@ -0,0 +1,62 @@
+import type { PageInfo } from "@next-core/runtime";
+/**
+ * 系统信息接口，包含认证信息、页面信息和品牌设置。
+ */
+export interface SystemInfo extends PageInfo {
+    /** 用户认证信息 */
+    username?: string;
+    userInstanceId?: string;
+    org?: number;
+    [key: string]: unknown;
+    /** 系统设置 */
+    settings: {
+        /** 品牌设置 */
+        brand: Record<string, string>;
+    };
+}
+/**
+ * 获取系统信息的 React hooks。
+ *
+ * 系统信息包括：
+ * - 用户认证信息（username, userInstanceId, org 等）
+ * - 页面信息（isInIframe, isInIframeOfNext 等）
+ * - 品牌设置（base_title 等）
+ *
+ * **注意**: 使用 useMemo 确保返回的对象引用稳定，
+ * 避免不必要的组件重渲染。系统信息在会话期间保持稳定。
+ *
+ * @example
+ *
+ * ```tsx
+ * function MyReactComponent() {
+ *   const sys = useSystemInfo();
+ *
+ *   return (
+ *     <div>
+ *       <p>User: {sys.username}</p>
+ *       <p>Org: {sys.org}</p>
+ *       <p>In iframe: {sys.isInIframe ? "Yes" : "No"}</p>
+ *       <p>Brand: {sys.settings.brand.base_title}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * // 检查是否在 iframe 中
+ * function IframeDetector() {
+ *   const sys = useSystemInfo();
+ *
+ *   if (sys.isInIframe) {
+ *     return <div>Running in iframe mode</div>;
+ *   }
+ *
+ *   return <div>Running in standalone mode</div>;
+ * }
+ * ```
+ *
+ * @returns 系统信息对象。
+ */
+export declare function useSystemInfo(): SystemInfo;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@next-core/react-runtime",
-  "version": "1.8.0",
+  "version": "1.10.0",
   "homepage": "https://github.com/easyops-cn/next-core/tree/v3/packages/react-runtime",
   "license": "GPL-3.0",
   "repository": {
@@ -49,5 +49,5 @@
     "@next-core/test-next": "^2.0.1",
     "jest-fetch-mock": "^3.0.3"
   },
-  "gitHead": "e9b30154f4d3981a1f706c791996d8fb0c1e49f1"
+  "gitHead": "8147d007b09c62b6f52349bc3d3daf98173a01f8"
 }