provide debug utilities for inspector via event communication

packages/@ember/-internals/metal/index.ts

@@ -70,8 +70,8 @@ export {
 } from './lib/observer';
 export { default as inject, DEBUG_INJECTION_FUNCTIONS } from './lib/injected_property';
 export { tagForProperty, tagForObject, markObjectAsDirty } from './lib/tags';
-export { tracked, TrackedDescriptor } from './lib/tracked';
-export { cached } from './lib/cached';
+export { tracked, TrackedDescriptor, isTrackedProperty } from './lib/tracked';
+export { cached, isCachedProperty } from './lib/cached';
 export { createCache, getValue, isConst } from './lib/cache';
 
 export {

packages/@ember/-internals/metal/lib/cached.ts

@@ -4,6 +4,8 @@
 import { DEBUG } from '@glimmer/env';
 import { createCache, getValue } from '@glimmer/validator';
 
+const CacheMap = new WeakMap();
+
 /**
  * @decorator
  *
@@ -84,7 +86,7 @@ import { createCache, getValue } from '@glimmer/validator';
  the subsequent cache invalidations of the `@cached` properties who were
  using this `trackedProp`.
 
- Remember that setting tracked data should only be done during initialization, 
+ Remember that setting tracked data should only be done during initialization,
  or as the result of a user action. Setting tracked data during render
  (such as in a getter), is not supported.
 
@@ -111,6 +113,11 @@ export const cached: MethodDecorator = (...args: any[]) => {
  throwCachedGetterOnlyError(key);
  }
 
+ if (!CacheMap.has(target)) {
+ CacheMap.set(target, new Set());
+ }
+ CacheMap.get(target).add(key);
+
  const caches = new WeakMap();
  const getter = descriptor.get;
 
@@ -144,3 +151,7 @@ function throwCachedInvalidArgsError(args: unknown[] = []): never {
  )}), which is not supported. Dependencies are automatically tracked, so you can just use ${'`@cached`'}`
  );
 }
+
+export function isCachedProperty(object: object, prop: string) {
+ return CacheMap.get(object)?.has(prop);
+}

packages/@ember/-internals/metal/lib/tracked.ts

@@ -200,3 +200,7 @@ export class TrackedDescriptor {
  this._set.call(obj, value);
  }
 }
+
+export function isTrackedProperty(object: object, prop: string): boolean {
+ return metaFor(object).peekDescriptors(prop) instanceof TrackedDescriptor;
+}

packages/@ember/-internals/utils/index.ts

@@ -32,4 +32,5 @@ export {
  setupMandatorySetter,
  teardownMandatorySetter,
  setWithMandatorySetter,
+ isMandatorySetter,
 } from './lib/mandatory-setter';

packages/@ember/-internals/utils/lib/mandatory-setter.ts

@@ -9,6 +9,8 @@ export let setupMandatorySetter:
 export let teardownMandatorySetter: ((obj: object, keyName: string | symbol) => void) | undefined;
 export let setWithMandatorySetter: ((obj: object, keyName: string, value: any) => void) | undefined;
 
+export let isMandatorySetter: ((obj: object, keyName: string) => boolean) | undefined;
+
 type PropertyDescriptorWithMeta = PropertyDescriptor & { hadOwnProperty?: boolean };
 
 function isElementKey(key: string | number | symbol) {
@@ -93,6 +95,11 @@ if (DEBUG) {
  });
  };
 
+ isMandatorySetter = function (obj: object, keyName: string) {
+ let setters = MANDATORY_SETTERS.get(obj);
+ return setters !== undefined && setters[keyName] !== undefined;
+ };
+
  teardownMandatorySetter = function (obj: object, keyName: string | symbol) {
  let setters = MANDATORY_SETTERS.get(obj);
 

packages/@ember/debug/ember-inspector.ts

@@ -0,0 +1,133 @@
+// required for inspector
+import { isTesting } from './lib/testing';
+import { _backburner, cancel, debounce, join, later, scheduleOnce } from '@ember/runloop';
+import { cacheFor, guidFor } from '@ember/object/internals';
+import { default as MutableArray } from '@ember/array/mutable';
+import { default as Namespace } from '@ember/application/namespace';
+import { default as MutableEnumerable } from '@ember/enumerable/mutable';
+import { NativeArray } from '@ember/array';
+import { ControllerMixin } from '@ember/controller';
+import { default as CoreObject } from '@ember/object/core';
+import { default as Application } from '@ember/application';
+import { default as EmberComponent } from '@ember/component';
+import { default as Observable } from '@ember/object/observable';
+import { default as Evented } from '@ember/object/evented';
+import { default as PromiseProxyMixin } from '@ember/object/promise-proxy-mixin';
+import { default as EmberObject } from '@ember/object';
+import { default as VERSION } from 'ember/version';
+import {
+ ComputedProperty,
+ isComputed,
+ descriptorForProperty,
+ descriptorForDecorator,
+ tagForProperty,
+ libraries,
+} from '@ember/-internals/metal';
+import { isMandatorySetter } from '@ember/-internals/utils';
+import { meta } from '@ember/-internals/meta';
+import { ActionHandler, TargetActionSupport } from '@ember/-internals/runtime';
+import {
+ ViewStateSupport,
+ ViewMixin,
+ ActionSupport,
+ ClassNamesSupport,
+ ChildViewsSupport,
+ CoreView,
+} from '@ember/-internals/views';
+import { set, get } from '@ember/object';
+import { isTrackedProperty } from '@ember/-internals/metal';
+import { isCachedProperty } from '@ember/-internals/metal';
+import { default as inspect } from './lib/inspect';
+import { subscribe } from '../instrumentation';
+import { default as captureRenderTree } from './lib/capture-render-tree';
+import { registerHandler as registerDeprecationHandler } from './lib/deprecate';
+import * as GlimmerValidator from '@glimmer/validator';
+import * as GlimmerRuntime from '@glimmer/runtime';
+import { getOwner } from '@ember/owner';
+import RSVP from 'rsvp';
+import Service from '@ember/service';
+import { ENV } from '@ember/-internals/environment';
+
+export function setupInspectorSupport() {
+ if (typeof window !== 'undefined' && window.addEventListener) {
+ window.addEventListener(
+ 'ember-inspector-debug-request',
+ () => {
+ const event = new CustomEvent('ember-inspector-debug-response', {
+ detail: {
+ utils: {
+ libraries,
+ },
+ runloop: {
+ _backburner,
+ cancel,
+ debounce,
+ join,
+ later,
+ scheduleOnce,
+ },
+ object: {
+ cacheFor,
+ guidFor,
+ getOwner,
+ set,
+ get,
+ },
+ debug: {
+ isComputed,
+ isTrackedProperty,
+ isCachedProperty,
+ descriptorForProperty,
+ descriptorForDecorator,
+ isMandatorySetter,
+ meta,
+ captureRenderTree,
+ isTesting,
+ inspect,
+ registerDeprecationHandler,
+ tagForProperty,
+ },
+ classes: {
+ ActionHandler,
+ Service,
+ ComputedProperty,
+ EmberObject,
+ MutableArray,
+ Namespace,
+ MutableEnumerable,
+ NativeArray,
+ TargetActionSupport,
+ ControllerMixin,
+ CoreObject,
+ Application,
+ EmberComponent,
+ Observable,
+ Evented,
+ PromiseProxyMixin,
+ RSVP,
+ },
+ VERSION,
+ ENV,
+ instrumentation: {
+ subscribe,
+ },
+ Views: {
+ ViewStateSupport,
+ ViewMixin,
+ ActionSupport,
+ ClassNamesSupport,
+ ChildViewsSupport,
+ CoreView,
+ },
+ glimmer: {
+ runtime: GlimmerRuntime,
+ validator: GlimmerValidator,
+ },
+ },
+ });
+ window.dispatchEvent(event);
+ },
+ false
+ );
+ }
+}

packages/@ember/debug/package.json

@@ -5,6 +5,7 @@
  "exports": {
  ".": "./index.ts",
  "./container-debug-adapter": "./container-debug-adapter.ts",
+ "./ember-inspector": "./ember-inspector.ts",
  "./data-adapter": "./data-adapter.ts"
  },
  "dependencies": {