react-native-mcp-kit 4.2.0 → 4.3.0

package/dist/babel/testIdPlugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/babel/testIdPlugin/index.ts"],"names":[],"mappings":"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"}

package/dist/babel/testIdPlugin/inject.d.ts

@@ -0,0 +1,7 @@
+import { type NodePath, type types as BabelTypes } from '@babel/core';
+import { type CollectedHook, type PluginPassWithQueue } from './types';
+export declare const buildHooksGetterStmt: (outer: string, inner: string, t: typeof BabelTypes) => BabelTypes.TryStatement;
+export declare const buildAssignmentStmt: (componentName: string, hooks: CollectedHook[], t: typeof BabelTypes) => BabelTypes.TryStatement;
+export declare const queueHooksAssignment: (state: PluginPassWithQueue, statementPath: NodePath<BabelTypes.Node>, componentName: string, hooks: CollectedHook[]) => void;
+export declare const queueHooksGetter: (state: PluginPassWithQueue, statementPath: NodePath<BabelTypes.Node>, outer: string, inner: string) => void;
+//# sourceMappingURL=inject.d.ts.map

package/dist/babel/testIdPlugin/inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../../src/babel/testIdPlugin/inject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AA4CvE,eAAO,MAAM,oBAAoB,UACxB,MAAM,SACN,MAAM,KACV,OAAO,UAAU,KACnB,UAAU,CAAC,YAmBb,CAAC;AAWF,eAAO,MAAM,mBAAmB,kBACf,MAAM,SACd,aAAa,EAAE,KACnB,OAAO,UAAU,KACnB,UAAU,CAAC,YAUb,CAAC;AASF,eAAO,MAAM,oBAAoB,UACxB,mBAAmB,iBACX,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,iBACzB,MAAM,SACd,aAAa,EAAE,KACrB,IAIF,CAAC;AAEF,eAAO,MAAM,gBAAgB,UACpB,mBAAmB,iBACX,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,SACjC,MAAM,SACN,MAAM,KACZ,IAGF,CAAC"}

package/dist/babel/testIdPlugin/inject.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queueHooksGetter = exports.queueHooksAssignment = exports.buildAssignmentStmt = exports.buildHooksGetterStmt = void 0;
+const buildHooksArrayExpr = (hooks, t) => {
+    return t.arrayExpression(hooks.map((h) => {
+        const props = [
+            t.objectProperty(t.identifier('name'), t.stringLiteral(h.name)),
+            t.objectProperty(t.identifier('kind'), t.stringLiteral(h.kind)),
+            t.objectProperty(t.identifier('hook'), t.stringLiteral(h.hook)),
+        ];
+        if (h.mcpId) {
+            props.push(t.objectProperty(t.identifier('mcpId'), t.stringLiteral(h.mcpId)));
+        }
+        if (h.fnIdent) {
+            // fn: useAuth   (runtime reads .__mcp_hooks off this identifier)
+            props.push(t.objectProperty(t.identifier('fn'), t.identifier(h.fnIdent)));
+        }
+        return t.objectExpression(props);
+    }));
+};
+// Build:
+//   try {
+//     Object.defineProperty(Outer, '__mcp_hooks', {
+//       configurable: true,
+//       get: () => Inner.__mcp_hooks,
+//     });
+//   } catch {}
+// Used for the identifier-ref HOC case (`const Outer = memo(Inner)`) where
+// we can't statically collect hooks from the wrapped function. The getter
+// forwards to the inner binding's metadata at read time, sidestepping
+// declaration order, hoisting, scope, and custom-HOC return shape.
+//
+// The try/catch is mandatory: the HOC's return value is statically unknown
+// — it could be a primitive (number / string), `null`/`undefined`, or a
+// frozen / sealed object. Any of those make `Object.defineProperty` throw
+// `TypeError` in strict mode (which ES modules always are). A throw at
+// module-init kills the bundle. Swallowing here is harmless: the worst
+// outcome is metadata not being attached to that one binding, exactly as
+// if the plugin had skipped it.
+const buildHooksGetterStmt = (outer, inner, t) => {
+    const defineCall = t.expressionStatement(t.callExpression(t.memberExpression(t.identifier('Object'), t.identifier('defineProperty')), [
+        t.identifier(outer),
+        t.stringLiteral('__mcp_hooks'),
+        t.objectExpression([
+            t.objectProperty(t.identifier('configurable'), t.booleanLiteral(true)),
+            t.objectProperty(t.identifier('get'), t.arrowFunctionExpression([], t.memberExpression(t.identifier(inner), t.identifier('__mcp_hooks')))),
+        ]),
+    ]));
+    // Optional-catch-binding (ES2019): `catch {}` — supported by Hermes.
+    return t.tryStatement(t.blockStatement([defineCall]), t.catchClause(null, t.blockStatement([])));
+};
+exports.buildHooksGetterStmt = buildHooksGetterStmt;
+// Build the `ComponentName.__mcp_hooks = [...]` statement, wrapped in a
+// `try { ... } catch {}` so a stale binding can't crash module-init. We
+// place these at the END of the program body — by the time they run, every
+// `var X = ...` in the file has been initialized. Without that placement,
+// react-compiler + react-native preset rewrite `const Foo = ...` to a
+// hoisted `var Foo = ...` whose binding is `undefined` until its source-line
+// is reached, and a worklets-extracted `var _worklet_..._init_data` slips
+// between our queued insertAfter target and the rebuilt declaration —
+// `Foo.__mcp_hooks = [...]` then runs against `undefined` and throws.
+const buildAssignmentStmt = (componentName, hooks, t) => {
+    const assignment = t.expressionStatement(t.assignmentExpression('=', t.memberExpression(t.identifier(componentName), t.identifier('__mcp_hooks')), buildHooksArrayExpr(hooks, t)));
+    return t.tryStatement(t.blockStatement([assignment]), t.catchClause(null, t.blockStatement([])));
+};
+exports.buildAssignmentStmt = buildAssignmentStmt;
+// Queue a `ComponentName.__mcp_hooks = [...]` insertion for `Program:exit`.
+// Inserting during the main traversal is unsafe: react-refresh's babel
+// plugin replaces HOC-wrapped function expressions via `replaceWith`, which
+// re-traverses the rebuilt subtree and (in our experience) drops sibling
+// statements we'd inserted via `insertAfter` on the original declarator.
+// Deferring to `Program:exit` keeps our writes visible to the final output
+// without interfering with replaceWith semantics.
+const queueHooksAssignment = (state, statementPath, componentName, hooks) => {
+    if (hooks.length === 0)
+        return;
+    const queue = (state.pendingInjects ??= []);
+    queue.push({ hooks, kind: 'assignment', outer: componentName, statementPath });
+};
+exports.queueHooksAssignment = queueHooksAssignment;
+const queueHooksGetter = (state, statementPath, outer, inner) => {
+    const queue = (state.pendingInjects ??= []);
+    queue.push({ inner, kind: 'getter', outer, statementPath });
+};
+exports.queueHooksGetter = queueHooksGetter;
+//# sourceMappingURL=inject.js.map

package/dist/babel/testIdPlugin/inject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.js","sourceRoot":"","sources":["../../../src/babel/testIdPlugin/inject.ts"],"names":[],"mappings":"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"}

package/dist/babel/testIdPlugin/types.d.ts

@@ -0,0 +1,59 @@
+import { type NodePath, type PluginPass, type types as BabelTypes } from '@babel/core';
+/**
+ * Per-file plugin state with deferred-injection queue. Babel instantiates
+ * `PluginPass` per file, so this naturally scopes the queue to a single
+ * transformation. We collect all the metadata assignments during the main
+ * traversal, then flush them at `Program:exit` — that runs AFTER other
+ * plugins' replaceWith calls (e.g. react-refresh wrapping HOC chains in
+ * `_s(...)` signature calls), so our injected statements aren't dropped by
+ * babel's re-traversal of the rebuilt subtrees.
+ */
+export type DeferredInsert = {
+    hooks: CollectedHook[];
+    kind: 'assignment';
+    outer: string;
+    statementPath: NodePath<BabelTypes.Node>;
+} | {
+    inner: string;
+    kind: 'getter';
+    outer: string;
+    statementPath: NodePath<BabelTypes.Node>;
+};
+export interface PluginPassWithQueue extends PluginPass {
+    pendingInjects?: DeferredInsert[];
+}
+export interface PluginOptions {
+    /** Attribute name to use. Default: "data-mcp-id" */
+    attr?: string;
+    /** Components to skip. Default: common wrappers */
+    exclude?: string[];
+    /** Components to add id to. Default: all capitalized JSX elements */
+    include?: string[];
+    /** Separator between parts. Default: ":" */
+    separator?: string;
+}
+export interface CollectedHook {
+    /** Source-level hook function name (`useState`, `useAnimatedStyle`, etc.).
+     * Surfaced to the agent alongside `name` (the consuming binding) so it
+     * can tell e.g. `count (useState)` from `count (useReducer)` without
+     * inferring from `kind`. For React.useXxx member-call form we still
+     * record just the property name (`useState`). */
+    hook: string;
+    kind: string;
+    name: string;
+    /**
+     * For Custom-kind entries: the source identifier of the hook function being
+     * called. Runtime reads `identifierRef.__mcp_hooks` to recursively expand
+     * sub-hooks, keeping slot alignment exact even when custom hooks span
+     * multiple built-in slots. Built-in hooks (State/Memo/...) don't need this.
+     */
+    fnIdent?: string;
+    /**
+     * Call-site identity in the same shape as JSX `data-mcp-id`:
+     * `<name>:<shortFile>:<line>`. Lets an agent `Read(<file>, <line>)`
+     * straight from a hook entry without grepping for the variable name.
+     * Empty when source location isn't available (synthetic AST nodes).
+     */
+    mcpId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/babel/testIdPlugin/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/babel/testIdPlugin/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,KAAK,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvF;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GACtB;IACE,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;CAC1C,GACD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAE/F,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B;;;;qDAIiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/babel/testIdPlugin/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/babel/testIdPlugin/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/babel/testIdPlugin/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { McpClient, McpContext, McpProvider, useMcpModule, useMcpTool } from './client/index';
 export { type McpContextValue, type McpModule, type McpProviderProps, type ToolHandler, } from './client/index';
-export { alertModule, fiberTreeModule, consoleModule, deviceModule, errorsModule, i18nextModule, navigationModule, networkModule, reactQueryModule, storageModule, } from './modules/index';
+export { alertModule, fiberTreeModule, consoleModule, deviceModule, errorsModule, i18nextModule, logBoxModule, navigationModule, networkModule, reactQueryModule, storageModule, } from './modules/index';
 export { type ClientMessage, type ModuleDescriptor, type ModuleToolDescriptor, type RegistrationMessage, type ServerMessage, type ToolRegisterMessage, type ToolRequest, type ToolResponse, type ToolUnregisterMessage, } from './shared/protocol';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.storageModule = exports.reactQueryModule = exports.networkModule = exports.navigationModule = exports.i18nextModule = exports.errorsModule = exports.deviceModule = exports.consoleModule = exports.fiberTreeModule = exports.alertModule = exports.useMcpTool = exports.useMcpModule = exports.McpProvider = exports.McpContext = exports.McpClient = void 0;
+exports.storageModule = exports.reactQueryModule = exports.networkModule = exports.navigationModule = exports.logBoxModule = exports.i18nextModule = exports.errorsModule = exports.deviceModule = exports.consoleModule = exports.fiberTreeModule = exports.alertModule = exports.useMcpTool = exports.useMcpModule = exports.McpProvider = exports.McpContext = exports.McpClient = void 0;
 // Client (safe for React Native)
 var index_1 = require("./client/index");
 Object.defineProperty(exports, "McpClient", { enumerable: true, get: function () { return index_1.McpClient; } });
@@ -16,6 +16,7 @@ Object.defineProperty(exports, "consoleModule", { enumerable: true, get: functio
 Object.defineProperty(exports, "deviceModule", { enumerable: true, get: function () { return index_2.deviceModule; } });
 Object.defineProperty(exports, "errorsModule", { enumerable: true, get: function () { return index_2.errorsModule; } });
 Object.defineProperty(exports, "i18nextModule", { enumerable: true, get: function () { return index_2.i18nextModule; } });
+Object.defineProperty(exports, "logBoxModule", { enumerable: true, get: function () { return index_2.logBoxModule; } });
 Object.defineProperty(exports, "navigationModule", { enumerable: true, get: function () { return index_2.navigationModule; } });
 Object.defineProperty(exports, "networkModule", { enumerable: true, get: function () { return index_2.networkModule; } });
 Object.defineProperty(exports, "reactQueryModule", { enumerable: true, get: function () { return index_2.reactQueryModule; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iCAAiC;AACjC,wCAA8F;AAArF,kGAAA,SAAS,OAAA;AAAE,mGAAA,UAAU,OAAA;AAAE,oGAAA,WAAW,OAAA;AAAE,qGAAA,YAAY,OAAA;AAAE,mGAAA,UAAU,OAAA;AAQrE,kCAAkC;AAClC,yCAWyB;AAVvB,oGAAA,WAAW,OAAA;AACX,wGAAA,eAAe,OAAA;AACf,sGAAA,aAAa,OAAA;AACb,qGAAA,YAAY,OAAA;AACZ,qGAAA,YAAY,OAAA;AACZ,sGAAA,aAAa,OAAA;AACb,yGAAA,gBAAgB,OAAA;AAChB,sGAAA,aAAa,OAAA;AACb,yGAAA,gBAAgB,OAAA;AAChB,sGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iCAAiC;AACjC,wCAA8F;AAArF,kGAAA,SAAS,OAAA;AAAE,mGAAA,UAAU,OAAA;AAAE,oGAAA,WAAW,OAAA;AAAE,qGAAA,YAAY,OAAA;AAAE,mGAAA,UAAU,OAAA;AAQrE,kCAAkC;AAClC,yCAYyB;AAXvB,oGAAA,WAAW,OAAA;AACX,wGAAA,eAAe,OAAA;AACf,sGAAA,aAAa,OAAA;AACb,qGAAA,YAAY,OAAA;AACZ,qGAAA,YAAY,OAAA;AACZ,sGAAA,aAAa,OAAA;AACb,qGAAA,YAAY,OAAA;AACZ,yGAAA,gBAAgB,OAAA;AAChB,sGAAA,aAAa,OAAA;AACb,yGAAA,gBAAgB,OAAA;AAChB,sGAAA,aAAa,OAAA"}

package/dist/modules/fiberTree/hooks/extract.d.ts

@@ -0,0 +1,6 @@
+import { type Fiber } from '../../../modules/fiberTree/types';
+import { type FlatHookEntry, type HooksOptions, type HookTreeNode } from './types';
+export declare const extractHooks: (fiber: Fiber, filter: HooksOptions & {
+    redactPatterns: RegExp[];
+}) => FlatHookEntry[] | HookTreeNode[] | null;
+//# sourceMappingURL=extract.d.ts.map

package/dist/modules/fiberTree/hooks/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../../src/modules/fiberTree/hooks/extract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAMvD,OAAO,EACL,KAAK,aAAa,EAGlB,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,SAAS,CAAC;AAGjB,eAAO,MAAM,YAAY,UAChB,KAAK,UACJ,YAAY,GAAG;IAAE,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE,KAClD,aAAa,EAAE,GAAG,YAAY,EAAE,GAAG,IA2LrC,CAAC"}

package/dist/modules/fiberTree/hooks/extract.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractHooks = void 0;
+const redact_1 = require("../../../modules/fiberTree/redact");
+const utils_1 = require("../../../modules/fiberTree/utils");
+const flatten_1 = require("./flatten");
+const shape_1 = require("./shape");
+const slotCount_1 = require("./slotCount");
+const value_1 = require("./value");
+const extractHooks = (fiber, filter) => {
+    // React's wrapper machinery makes "where does metadata live" depend on
+    // the exact HOC chain. We try the most likely homes in order:
+    //
+    //   1. `fiber.type.__mcp_hooks` — bare components, FunctionDeclarations,
+    //      and the outer memo fiber when the chain is just memo(fn).
+    //   2. `fiber.elementType.__mcp_hooks` — memo(fn) without compare.
+    //      React converts the fiber to SimpleMemoComponent and rewrites
+    //      `fiber.type` to the inner function (see `updateMemoComponent` in
+    //      ReactFabric); our metadata sits on the outer memo wrapper, which
+    //      survives only on `elementType`.
+    //   3. `fiber.type.render.__mcp_hooks` — forwardRef wrapper. React lays
+    //      out memo(forwardRef(fn)) as three fibers (memo → forwardRef →
+    //      function). When the user queries by displayName they tend to
+    //      match the middle ForwardRef fiber (whose displayName resolves
+    //      via `render.displayName`); fiber.type there is the forwardRef
+    //      wrapper, which holds the inner fn at `.render`. The babel plugin
+    //      put plain metadata on that fn via the FunctionDecl visitor.
+    //   4. `fiber.type.type.__mcp_hooks` — memo wrapper around forwardRef
+    //      (or any non-function inner). Not the SimpleMemoComponent path,
+    //      so `fiber.type` stays as the memo wrapper and `.type` is the
+    //      inner forwardRef / class / etc. This catches getter installations
+    //      on the wrapper layer too.
+    const candidates = [
+        fiber.type,
+        fiber.elementType,
+        fiber.type?.render,
+        fiber.type?.type,
+    ];
+    let rawMeta;
+    for (const c of candidates) {
+        const m = c?.__mcp_hooks;
+        if (Array.isArray(m)) {
+            rawMeta = m;
+            break;
+        }
+    }
+    if (!Array.isArray(rawMeta))
+        return null;
+    const meta = (0, flatten_1.flattenHookMeta)(rawMeta, [], new WeakSet(), filter.expansionDepth);
+    const out = [];
+    let state = fiber.memoizedState;
+    let metaIdx = 0;
+    // Walk the fiber's hook chain and pair each slot with the next metadata
+    // entry whose `kind` is shape-compatible with the slot. Strongly-shaped
+    // kinds (Ref / Memo / Callback / Effect) match only the corresponding
+    // React hook shape. Permissive kinds (State / Reducer / Context / Custom)
+    // reject obvious mismatches (effect-record, ref-shape) so they don't
+    // swallow slots belonging to preceding custom hooks.
+    //
+    // For Custom-leaf entries — typically black-box library hooks
+    // (`useSelector`, `useQuery`, etc.) where flattenHookMeta couldn't expand
+    // because `fn.__mcp_hooks` was missing — we estimate slot count via
+    // `countHookSlots` and advance the fiber chain by that many slots in one
+    // step. Without this, a hook that consumes 3 internal slots only
+    // advances by 1 in the walker, drifting all trailing entries off the end
+    // of the chain.
+    const emitEntry = (entry, rawValueSlot) => {
+        const { hook, kind, mcpId, name, via } = entry;
+        const passesKind = !filter.kindsSet || filter.kindsSet.has(kind);
+        const passesName = !filter.nameMatchers ||
+            filter.nameMatchers.some((m) => {
+                return m(name);
+            });
+        const passesMcpId = !filter.mcpIdMatchers ||
+            (mcpId !== undefined &&
+                filter.mcpIdMatchers.some((m) => {
+                    return m(mcpId);
+                }));
+        if (!(passesKind && passesName && passesMcpId))
+            return;
+        const record = { kind, name };
+        // Prefer the babel-emitted hook name; fall back to fn.name for entries
+        // produced by older bundles that predate the `hook` field.
+        const resolvedHook = hook ?? (typeof entry.fn === 'function' ? entry.fn.name : undefined);
+        if (resolvedHook)
+            record.hook = resolvedHook;
+        if (mcpId)
+            record.mcpId = mcpId;
+        if (filter.withValues && rawValueSlot !== undefined) {
+            // Redaction guard: mask the value (but keep kind/name/hook visible)
+            // when the entry's name OR any ancestor in `via` matches a redact
+            // pattern. Catches both direct sensitive hooks (`password` State)
+            // and leaves nested under sensitive customs (a `value` field of
+            // `useCredentials()` won't slip through).
+            const isRedacted = (0, redact_1.matchesAnyRedactPattern)(name, filter.redactPatterns) ||
+                (via?.some((v) => {
+                    return (0, redact_1.matchesAnyRedactPattern)(v, filter.redactPatterns);
+                }) ??
+                    false);
+            if (isRedacted) {
+                record.value = redact_1.REDACTED_VALUE;
+            }
+            else {
+                let value;
+                try {
+                    // Kind-aware extraction (Ref's .current, Memo's first slot, ...)
+                    // returns RAW. Then project with the user-given hook-value options
+                    // (path / depth / maxBytes from select.hooks). Default depth=1 so
+                    // each hook value stays compact even when withValues:true.
+                    const extracted = (0, value_1.serializeHookValue)(rawValueSlot, kind);
+                    value = (0, utils_1.projectFiberValue)(extracted, {
+                        depth: filter.valueDepth ?? 1,
+                        maxBytes: filter.valueMaxBytes,
+                        path: filter.valuePath,
+                    });
+                    // Final cycle / non-serialisable check — the MCP bridge will
+                    // stringify this for transport, so bail now rather than killing
+                    // the whole response if one stray value carries a cycle past our
+                    // WeakSet (e.g. Proxy, lazy getter, native-bridged object).
+                    JSON.stringify(value);
+                }
+                catch {
+                    value = '[Unserialisable value]';
+                }
+                record.value = value;
+            }
+        }
+        if (via && via.length > 0)
+            record.via = via;
+        if (entry.expanded)
+            record.expanded = true;
+        out.push(record);
+    };
+    const advanceState = (steps) => {
+        for (let i = 0; i < steps && state; i++)
+            state = state.next;
+    };
+    while (state && metaIdx < meta.length) {
+        const entry = meta[metaIdx];
+        if (!entry) {
+            metaIdx++;
+            continue;
+        }
+        // Expanded parent (synthetic, marks the call-site of a recursively
+        // expanded custom hook). Emit without consuming any fiber slot — the
+        // children that follow are the real slot-bearing entries.
+        if (entry.expanded) {
+            emitEntry(entry, undefined);
+            metaIdx++;
+            continue;
+        }
+        // Custom-leaf with a known fn → recurse into source to estimate slot
+        // count, then consume that many slots at once. The first slot's value
+        // is exposed (best approximation of "this hook's value"); the rest are
+        // skipped silently as internals of the library hook.
+        if (entry.kind === 'Custom' && typeof entry.fn === 'function') {
+            const slots = (0, slotCount_1.countHookSlots)(entry.fn);
+            if (slots > 1) {
+                emitEntry(entry, state.memoizedState);
+                advanceState(slots);
+                metaIdx++;
+                continue;
+            }
+        }
+        if (!(0, shape_1.shapeMatchesKind)(state.memoizedState, entry.kind)) {
+            state = state.next;
+            continue;
+        }
+        emitEntry(entry, state.memoizedState);
+        metaIdx++;
+        state = state.next;
+    }
+    // Any metadata entries left after the fiber chain ran dry didn't get a
+    // slot match. Emit them anyway (without value) so the agent at least
+    // sees the hook exists — this is strictly better than silently dropping,
+    // and helps debug alignment issues. Common cause: a preceding Custom
+    // hook consumed more slots than countHookSlots estimated.
+    while (metaIdx < meta.length) {
+        const entry = meta[metaIdx];
+        if (entry)
+            emitEntry(entry, undefined);
+        metaIdx++;
+    }
+    return filter.format === 'tree' ? (0, flatten_1.flatHooksToTree)(out) : out;
+};
+exports.extractHooks = extractHooks;
+//# sourceMappingURL=extract.js.map

package/dist/modules/fiberTree/hooks/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../../../src/modules/fiberTree/hooks/extract.ts"],"names":[],"mappings":"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"}

package/dist/modules/fiberTree/hooks/flatten.d.ts

@@ -0,0 +1,4 @@
+import { type FlatHookEntry, type FlattenedHook, type HookMeta, type HookTreeNode } from './types';
+export declare const flattenHookMeta: (meta: HookMeta[], via?: string[], seen?: WeakSet<object>, maxDepth?: number) => FlattenedHook[];
+export declare const flatHooksToTree: (flat: FlatHookEntry[]) => HookTreeNode[];
+//# sourceMappingURL=flatten.d.ts.map

package/dist/modules/fiberTree/hooks/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../../../src/modules/fiberTree/hooks/flatten.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAcnG,eAAO,MAAM,eAAe,SACpB,QAAQ,EAAE,QACX,MAAM,EAAE,SACP,OAAO,CAAC,MAAM,CAAC,wBAEpB,aAAa,EAoBf,CAAC;AAOF,eAAO,MAAM,eAAe,SAAU,aAAa,EAAE,KAAG,YAAY,EA8BnE,CAAC"}

package/dist/modules/fiberTree/hooks/flatten.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flatHooksToTree = exports.flattenHookMeta = void 0;
+// Flatten a metadata array by recursively inlining custom-hook sub-metadata.
+// Stops on cycles (hook references itself) and on Custom entries whose `fn`
+// isn't annotated (library hooks that bypassed the babel plugin — usually
+// pre-compiled node_modules). Such unannotated entries stay as single
+// records and rely on shape-check for alignment.
+//
+// Custom entries with annotated `fn` produce TWO records: a parent (marked
+// `expanded: true`, no slot consumption) followed by all flattened
+// children. This keeps the call-site visible in the output — without it
+// the agent would see e.g. `wrapperAnimStyle.areAnimationsActive` deep
+// in `via:` but never the `wrapperAnimStyle = useAnimatedStyle(...)`
+// invocation that owns those slots.
+const flattenHookMeta = (meta, via = [], seen = new WeakSet(), maxDepth = Infinity) => {
+    const out = [];
+    for (const entry of meta) {
+        const fn = entry.fn;
+        const sub = fn && typeof fn === 'function' && Array.isArray(fn.__mcp_hooks) ? fn.__mcp_hooks : undefined;
+        // Stop expanding once `via.length` would reach the cap — at that point
+        // the current entry is treated as a leaf (Custom record without
+        // children). The slot-walker still pairs it with one slot, so output
+        // stays internally consistent.
+        if (sub && !seen.has(fn) && via.length < maxDepth) {
+            seen.add(fn);
+            out.push({ ...entry, expanded: true, via });
+            out.push(...(0, exports.flattenHookMeta)(sub, [...via, entry.name], seen, maxDepth));
+            seen.delete(fn);
+        }
+        else {
+            out.push({ ...entry, via });
+        }
+    }
+    return out;
+};
+exports.flattenHookMeta = flattenHookMeta;
+// Convert the flat output of the slot walker into a nested tree using the
+// `via` prefix as the parent chain. Each `expanded: true` entry becomes a
+// node that owns subsequent entries whose `via` extends the parent's path.
+// Stack-based single pass — no recursion. Strips `expanded` from the
+// returned shape since structure makes the parent obvious.
+const flatHooksToTree = (flat) => {
+    const root = [];
+    // Stack of currently-open parents, indexed by their depth (= via.length
+    // of THEIR own entry, since their children sit at via.length + 1).
+    const parents = [];
+    for (const entry of flat) {
+        const depth = entry.via?.length ?? 0;
+        while (parents.length > depth)
+            parents.pop();
+        const node = { kind: entry.kind, name: entry.name };
+        if (entry.hook !== undefined)
+            node.hook = entry.hook;
+        if (entry.mcpId !== undefined)
+            node.mcpId = entry.mcpId;
+        if (entry.value !== undefined)
+            node.value = entry.value;
+        if (parents.length === 0) {
+            root.push(node);
+        }
+        else {
+            const parent = parents[parents.length - 1];
+            if (parent) {
+                parent.children = parent.children ?? [];
+                parent.children.push(node);
+            }
+            else {
+                root.push(node);
+            }
+        }
+        if (entry.expanded) {
+            // Push as the new active parent at this depth. Subsequent entries
+            // with via.length > depth become this node's descendants.
+            parents.push(node);
+        }
+    }
+    return root;
+};
+exports.flatHooksToTree = flatHooksToTree;
+//# sourceMappingURL=flatten.js.map

package/dist/modules/fiberTree/hooks/flatten.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.js","sourceRoot":"","sources":["../../../../src/modules/fiberTree/hooks/flatten.ts"],"names":[],"mappings":"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"}

package/dist/modules/fiberTree/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export { extractHooks } from './extract';
+export { buildHooksOptions } from './options';
+export { parseNamePattern } from './patterns';
+export { type FlatHookEntry, type HookMeta, type HooksOptions, type HooksRawOptions, type HookTreeNode, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/fiberTree/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/fiberTree/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}

package/dist/modules/fiberTree/hooks/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseNamePattern = exports.buildHooksOptions = exports.extractHooks = void 0;
+var extract_1 = require("./extract");
+Object.defineProperty(exports, "extractHooks", { enumerable: true, get: function () { return extract_1.extractHooks; } });
+var options_1 = require("./options");
+Object.defineProperty(exports, "buildHooksOptions", { enumerable: true, get: function () { return options_1.buildHooksOptions; } });
+var patterns_1 = require("./patterns");
+Object.defineProperty(exports, "parseNamePattern", { enumerable: true, get: function () { return patterns_1.parseNamePattern; } });
+//# sourceMappingURL=index.js.map

package/dist/modules/fiberTree/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/fiberTree/hooks/index.ts"],"names":[],"mappings":";;;AAAA,qCAAyC;AAAhC,uGAAA,YAAY,OAAA;AACrB,qCAA8C;AAArC,4GAAA,iBAAiB,OAAA;AAC1B,uCAA8C;AAArC,4GAAA,gBAAgB,OAAA"}

package/dist/modules/fiberTree/hooks/options.d.ts

@@ -0,0 +1,9 @@
+import { type HooksOptions, type HooksRawOptions } from './types';
+/**
+ * Normalise a raw `select.hooks` object into the strict `HooksOptions`
+ * shape the extractor walks against. Splits ambiguous fields (`depth` →
+ * `valueDepth`, etc.) and compiles name-pattern strings via
+ * `parseNamePattern`. Used by `parseProjection`.
+ */
+export declare const buildHooksOptions: (raw: HooksRawOptions | undefined) => HooksOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/modules/fiberTree/hooks/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../src/modules/fiberTree/hooks/options.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QAAS,eAAe,GAAG,SAAS,KAAG,YAgBpE,CAAC"}

package/dist/modules/fiberTree/hooks/options.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildHooksOptions = void 0;
+const patterns_1 = require("./patterns");
+/**
+ * Normalise a raw `select.hooks` object into the strict `HooksOptions`
+ * shape the extractor walks against. Splits ambiguous fields (`depth` →
+ * `valueDepth`, etc.) and compiles name-pattern strings via
+ * `parseNamePattern`. Used by `parseProjection`.
+ */
+const buildHooksOptions = (raw) => {
+    return {
+        expansionDepth: typeof raw?.expansionDepth === 'number' && raw.expansionDepth >= 0
+            ? Math.floor(raw.expansionDepth)
+            : Infinity,
+        format: raw?.format === 'tree' ? 'tree' : 'flat',
+        kindsSet: Array.isArray(raw?.kinds) ? new Set(raw.kinds) : null,
+        mcpIdMatchers: Array.isArray(raw?.mcpIds) ? raw.mcpIds.map(patterns_1.parseNamePattern) : null,
+        nameMatchers: Array.isArray(raw?.names) ? raw.names.map(patterns_1.parseNamePattern) : null,
+        valueDepth: typeof raw?.depth === 'number' && raw.depth >= 0 ? raw.depth : undefined,
+        valueMaxBytes: typeof raw?.maxBytes === 'number' && raw.maxBytes >= 0 ? raw.maxBytes : undefined,
+        valuePath: typeof raw?.path === 'string' ? raw.path : undefined,
+        withValues: raw?.withValues === true,
+    };
+};
+exports.buildHooksOptions = buildHooksOptions;
+//# sourceMappingURL=options.js.map