@momo-kits/foundation 0.169.4-beta.8 → 0.169.4

package/Application/KitAdoption/types.ts

@@ -1,48 +0,0 @@
-type AdoptionBucket = 'K' | 'R' | 'O';
-
-type SnapshotStatus = 'ok' | 'dev_bundle' | 'truncated' | 'error';
-
-type WalkResult = {
-  counts: { K: number; R: number; O: number };
-  kit: Record<string, number>;
-  rn: Record<string, number>;
-  other: Record<string, number>;
-  top_transparent: { name: string; count: number }[];
-  fibers: number;
-  truncated: boolean;
-  status: SnapshotStatus;
-};
-
-type ScreenSnapshot = WalkResult & {
-  app_id: string;
-  screen_name: string;
-  foundation_version?: string;
-  platform: string;
-  ts: number;
-  walk_ms: number;
-};
-
-type FiberLike = {
-  tag: number;
-  type: unknown;
-  child?: FiberLike | null;
-  sibling?: FiberLike | null;
-  return?: FiberLike | null;
-  alternate?: FiberLike | null;
-  memoizedProps?: unknown;
-  _debugStack?: unknown;
-  _debugOwner?: unknown;
-  stateNode?: unknown;
-};
-
-/** Identity sets of component objects: kit exports and RN primitives. */
-type KitRegistries = { kit: WeakSet<object>; rn: WeakSet<object> };
-
-export type {
-  AdoptionBucket,
-  FiberLike,
-  KitRegistries,
-  ScreenSnapshot,
-  SnapshotStatus,
-  WalkResult,
-};

package/Application/KitAdoption/utils.ts

@@ -1,393 +0,0 @@
-import { Fragment, isValidElement } from 'react';
-
-import {
-  COUNTED_FIBER_TAGS,
-  FIBER_TAG,
-  FOUNDATION_REEXPORT_NAMES,
-  HOST_RN_PREFIXES,
-  LIB_UNIT_NAMES,
-  MAX_FIBERS,
-  REACT_FORWARD_REF_TYPE,
-  REACT_MEMO_TYPE,
-  RN_PRIMITIVE_NAMES,
-  SLOT_SCAN_DEPTH,
-  TOP_TRANSPARENT_LIMIT,
-} from './constants';
-import type {
-  AdoptionBucket,
-  FiberLike,
-  KitRegistries,
-  SnapshotStatus,
-  WalkResult,
-} from './types';
-
-const ANONYMOUS_NAME = 'Anonymous';
-const UNKNOWN_APP_ID = 'unknown';
-
-type LooseObject = Record<string, unknown>;
-type Classification = AdoptionBucket | 'unit' | 'transparent';
-type WalkEntry = { fiber: FiberLike; unitSlots: Set<unknown> | null };
-type Tally = {
-  counts: Record<AdoptionBucket, number>;
-  names: Record<AdoptionBucket, Record<string, number>>;
-  transparent: Record<string, number>;
-  appAuthoredSeen: boolean;
-};
-
-/**
- * True for non-null objects and functions, the only values React fibers and
- * component types can hold.
- */
-const isObjectLike = (value: unknown): value is LooseObject =>
-  (typeof value === 'object' && value !== null) || typeof value === 'function';
-
-/** Non-empty string name, or undefined. */
-const readName = (value: unknown): string | undefined =>
-  typeof value === 'string' && value !== '' ? value : undefined;
-
-const readNameOf = (value: unknown): string | undefined =>
-  isObjectLike(value) ? readName(value.name) : undefined;
-
-/** Runs a read that may throw (RN exports use throwing getters); returns undefined on failure. */
-const readSafely = (read: () => unknown): unknown => {
-  try {
-    return read();
-  } catch {
-    return undefined;
-  }
-};
-
-/** Functions and React exotic objects ($$typeof) are component candidates. */
-const isComponentLike = (value: unknown): value is object =>
-  typeof value === 'function' ||
-  (isObjectLike(value) && value.$$typeof !== undefined);
-
-const isInSet = (set: WeakSet<object>, value: unknown): boolean =>
-  isObjectLike(value) && set.has(value);
-
-/** Adds a non-null object-typed count, keeping prototype keys (e.g. "constructor") out of the lookup. */
-const incrementName = (record: Record<string, number>, name: string): void => {
-  const current = Object.prototype.hasOwnProperty.call(record, name)
-    ? record[name]
-    : 0;
-  record[name] = current + 1;
-};
-
-/**
- * Returns the live copy of a fiber: the one under the committed HostRoot,
- * otherwise its alternate. Walking a stale copy would count the old tree.
- */
-const getCurrentFiber = (fiber: FiberLike): FiberLike => {
-  let hostRoot: FiberLike | null | undefined = fiber;
-  while (hostRoot && hostRoot.tag !== FIBER_TAG.HostRoot) {
-    hostRoot = hostRoot.return;
-  }
-  if (!hostRoot) return fiber;
-  const root = hostRoot.stateNode as { current?: unknown } | null | undefined;
-  return root?.current === hostRoot ? fiber : fiber.alternate ?? fiber;
-};
-
-/** Inner component of a React.memo or forwardRef wrapper, or undefined for other types. */
-const getWrappedType = (type: LooseObject): unknown => {
-  if (type.$$typeof === REACT_MEMO_TYPE) return type.type;
-  if (type.$$typeof === REACT_FORWARD_REF_TYPE) return type.render;
-  return undefined;
-};
-
-/**
- * Strips memo and forwardRef wrappers (recursively) to reach the underlying
- * component, since a fiber's type is often the wrapper.
- */
-const unwrapType = (type: unknown): unknown => {
-  if (!isObjectLike(type)) return type;
-  const inner = getWrappedType(type);
-  return inner === undefined ? type : unwrapType(inner);
-};
-
-/**
- * Display name for a fiber type, following wrappers when the type has no name
- * of its own. Used for lib-unit matching and the report.
- */
-const getTypeName = (type: unknown): string => {
-  if (typeof type === 'string') return type;
-  if (!isObjectLike(type)) return ANONYMOUS_NAME;
-  return (
-    readName(type.displayName) ??
-    readName(type.name) ??
-    readNameOf(type.render) ??
-    readNameOf(type.type) ??
-    ANONYMOUS_NAME
-  );
-};
-
-/** Adds a component and its unwrapped form to the set. */
-const addRegistryEntry = (set: WeakSet<object>, value: unknown): void => {
-  if (!isComponentLike(value)) return;
-  set.add(value);
-  const inner = unwrapType(value);
-  if (isObjectLike(inner)) set.add(inner);
-};
-
-/**
- * Builds the identity sets used to classify fibers. RN is read by name only,
- * because enumerating react-native exports hits throwing getters.
- */
-const createRegistries = (
-  kitModules: Record<string, unknown>[],
-  rnModule: Record<string, unknown>,
-): KitRegistries => {
-  const kit = new WeakSet<object>();
-  const rn = new WeakSet<object>();
-  kitModules.forEach(mod => {
-    Object.keys(mod).forEach(name => {
-      if (FOUNDATION_REEXPORT_NAMES.includes(name)) return;
-      addRegistryEntry(
-        kit,
-        readSafely(() => mod[name]),
-      );
-    });
-  });
-  RN_PRIMITIVE_NAMES.forEach(name => {
-    addRegistryEntry(
-      rn,
-      readSafely(() => rnModule[name]),
-    );
-  });
-  return { kit, rn };
-};
-
-/**
- * The fiber whose stack decides authorship. React creates the inner fiber of a
- * MemoComponent itself, with no stack, so it inherits its memo parent's.
- */
-const getAuthorFiber = (fiber: FiberLike): FiberLike =>
-  fiber.return?.tag === FIBER_TAG.MemoComponent && fiber.return.child === fiber
-    ? fiber.return
-    : fiber;
-
-/**
- * True when the fiber has no dev stack, i.e. it was created by mini-app code
- * (prod bundle) rather than by the host's dev build.
- */
-const isAppAuthored = (fiber: FiberLike): boolean => !fiber._debugStack;
-
-/**
- * True when the fiber's first child was created by host code and is owned by
- * this fiber, which marks a host-internal wrapper.
- */
-const isHostDefined = (fiber: FiberLike): boolean => {
-  const child = fiber.child;
-  return !!child && !isAppAuthored(child) && child._debugOwner === fiber;
-};
-
-/** App id from the mini-app context, or a placeholder when it is missing. */
-const getAppId = (context: unknown): string => {
-  if (!isObjectLike(context) || context.appId == null) return UNKNOWN_APP_ID;
-  return String(context.appId);
-};
-
-/**
- * Adds the props of React elements that the app passed into a lib unit, found
- * among the props and in arrays up to SLOT_SCAN_DEPTH. Never looks inside an element.
- */
-const collectSlotProps = (
-  props: unknown,
-  set: Set<unknown>,
-  depth: number,
-): void => {
-  if (depth > SLOT_SCAN_DEPTH || !isObjectLike(props)) return;
-  Object.values(props).forEach(value => {
-    if (isValidElement(value)) {
-      set.add(value.props);
-      if (value.type === Fragment)
-        collectSlotProps(value.props, set, depth + 1);
-    } else if (Array.isArray(value)) {
-      collectSlotProps(value, set, depth + 1);
-    }
-  });
-};
-
-/** True for host string types that come from react-native's native components. */
-const isRnHostType = (type: unknown): boolean =>
-  typeof type === 'string' &&
-  HOST_RN_PREFIXES.some(prefix => type.startsWith(prefix));
-
-/**
- * Buckets a fiber: K/R/O for kit, RN and other components, 'unit' for lib
- * units (counted once), or 'transparent' for app wrappers that are not counted.
- */
-const classifyFiber = (
-  fiber: FiberLike,
-  registries: KitRegistries,
-): Classification => {
-  if (fiber.tag === FIBER_TAG.HostComponent) {
-    return isRnHostType(fiber.type) ? 'R' : 'O';
-  }
-  const inner = unwrapType(fiber.type);
-  if (isInSet(registries.kit, fiber.type) || isInSet(registries.kit, inner)) {
-    return 'K';
-  }
-  if (isInSet(registries.rn, fiber.type) || isInSet(registries.rn, inner)) {
-    return 'R';
-  }
-  if (LIB_UNIT_NAMES.includes(getTypeName(fiber.type))) return 'unit';
-  return isHostDefined(fiber) ? 'O' : 'transparent';
-};
-
-const createTally = (): Tally => ({
-  counts: { K: 0, R: 0, O: 0 },
-  names: { K: {}, R: {}, O: {} },
-  transparent: {},
-  appAuthoredSeen: false,
-});
-
-const countComponent = (
-  tally: Tally,
-  bucket: AdoptionBucket,
-  name: string,
-): void => {
-  tally.counts[bucket] += 1;
-  incrementName(tally.names[bucket], name);
-};
-
-/** Top transparent wrapper names by count, most frequent first. */
-const topEntries = (
-  record: Record<string, number>,
-): { name: string; count: number }[] =>
-  Object.keys(record)
-    .map(name => ({ name, count: record[name] }))
-    .sort((a, b) => b.count - a.count)
-    .slice(0, TOP_TRANSPARENT_LIMIT);
-
-const getStatus = (
-  truncated: boolean,
-  fibers: number,
-  appAuthoredSeen: boolean,
-): SnapshotStatus => {
-  if (truncated) return 'truncated';
-  if (fibers > 0 && !appAuthoredSeen) return 'dev_bundle';
-  return 'ok';
-};
-
-const buildResult = (
-  tally: Tally,
-  fibers: number,
-  truncated: boolean,
-): WalkResult => ({
-  counts: { ...tally.counts },
-  kit: tally.names.K,
-  rn: tally.names.R,
-  other: tally.names.O,
-  top_transparent: topEntries(tally.transparent),
-  fibers,
-  truncated,
-  status: getStatus(truncated, fibers, tally.appAuthoredSeen),
-});
-
-/**
- * Queues the children of a fiber (and their siblings) with the given slot set.
- * Slot sets only pass through lib-unit internals and walk-through fibers.
- */
-const pushChildren = (
-  fiber: FiberLike,
-  unitSlots: Set<unknown> | null,
-  stack: WalkEntry[],
-): void => {
-  for (let child = fiber.child; child; child = child.sibling) {
-    stack.push({ fiber: child, unitSlots });
-  }
-};
-
-/**
- * Counts one app-scope fiber. A lib unit counts as K once; its slot props are
- * collected so that the app-passed descendants are counted too.
- */
-const countFiber = (
-  fiber: FiberLike,
-  registries: KitRegistries,
-  tally: Tally,
-  stack: WalkEntry[],
-): void => {
-  const name = getTypeName(fiber.type);
-  const kind = classifyFiber(fiber, registries);
-  if (kind === 'unit') {
-    countComponent(tally, 'K', name);
-    const slots = new Set<unknown>();
-    collectSlotProps(fiber.memoizedProps, slots, 0);
-    pushChildren(fiber, slots, stack);
-    return;
-  }
-  if (kind === 'transparent') {
-    incrementName(tally.transparent, name);
-  } else {
-    countComponent(tally, kind, name);
-  }
-  pushChildren(fiber, null, stack);
-};
-
-/**
- * Handles one popped fiber: walk-through tags and lib-unit internals are
- * only traversed, host-defined fibers are skipped, and app-scope fibers are counted.
- */
-const visitEntry = (
-  entry: WalkEntry,
-  registries: KitRegistries,
-  tally: Tally,
-  stack: WalkEntry[],
-): void => {
-  const { fiber, unitSlots } = entry;
-  if (!COUNTED_FIBER_TAGS.includes(fiber.tag)) {
-    pushChildren(fiber, unitSlots, stack);
-    return;
-  }
-  if (unitSlots && !unitSlots.has(fiber.memoizedProps)) {
-    pushChildren(fiber, unitSlots, stack);
-    return;
-  }
-  if (!isAppAuthored(getAuthorFiber(fiber))) {
-    pushChildren(fiber, null, stack);
-    return;
-  }
-  tally.appAuthoredSeen = true;
-  countFiber(fiber, registries, tally, stack);
-};
-
-/**
- * Walks a screen's fiber tree from rootFiber (not its siblings) and tallies
- * app-authored kit, RN and other components. Stops at maxFibers and marks truncated.
- */
-const walkScreen = (
-  rootFiber: FiberLike,
-  registries: KitRegistries,
-  stopAt?: (fiber: FiberLike) => boolean,
-  maxFibers = MAX_FIBERS,
-): WalkResult => {
-  const tally = createTally();
-  const stack: WalkEntry[] = [{ fiber: rootFiber, unitSlots: null }];
-  let fibers = 0;
-  let truncated = false;
-  for (let entry = stack.pop(); entry; entry = stack.pop()) {
-    if (fibers === maxFibers) {
-      truncated = true;
-      break;
-    }
-    fibers += 1;
-    if (entry.fiber !== rootFiber && stopAt?.(entry.fiber)) continue;
-    visitEntry(entry, registries, tally, stack);
-  }
-  return buildResult(tally, fibers, truncated);
-};
-
-export {
-  classifyFiber,
-  collectSlotProps,
-  createRegistries,
-  getAppId,
-  getAuthorFiber,
-  getCurrentFiber,
-  getTypeName,
-  isAppAuthored,
-  isHostDefined,
-  unwrapType,
-  walkScreen,
-};

package/Application/__tests__/KitAdoption.integration.test.tsx

@@ -1,235 +0,0 @@
-jest.unmock('react-native');
-
-/* Native packages are stubbed: the real modules are ESM or need native code under jest. */
-jest.mock('react-native-reanimated', () => {
-  const { View, Text, Image } = require('react-native');
-  const Animated = {
-    View,
-    Text,
-    Image,
-    createAnimatedComponent: (component: unknown) => component,
-  };
-  return {
-    __esModule: true,
-    default: Animated,
-    ...Animated,
-    useSharedValue: (value: unknown) => ({ value }),
-    useAnimatedStyle: () => ({}),
-    useDerivedValue: (fn: () => unknown) => ({ value: fn() }),
-    withTiming: (value: unknown) => value,
-    withSpring: (value: unknown) => value,
-    runOnJS: (fn: unknown) => fn,
-    interpolate: () => 0,
-  };
-});
-jest.mock('react-native-fast-image', () => {
-  const mockReact = require('react');
-  const FastImageStub = (props: Record<string, unknown>) =>
-    mockReact.createElement('FastImage', props);
-  return { __esModule: true, default: FastImageStub };
-});
-jest.mock('react-native-linear-gradient', () => {
-  const mockReact = require('react');
-  const LinearGradientStub = (props: Record<string, unknown>) =>
-    mockReact.createElement('LinearGradient', props);
-  return { __esModule: true, default: LinearGradientStub };
-});
-jest.mock('lottie-react-native', () => {
-  const mockReact = require('react');
-  const LottieStub = () => null;
-  return { __esModule: true, default: mockReact.forwardRef(LottieStub) };
-});
-jest.mock('../../Application', () => ({
-  useComponentId: () => ({ componentId: 'test-id' }),
-}));
-
-import React, { Fragment, type ElementType, type ReactNode } from 'react';
-import {
-  FlatList,
-  Image,
-  Text as RNText,
-  TouchableOpacity,
-  View,
-} from 'react-native';
-import { act, create, type ReactTestRenderer } from 'react-test-renderer';
-
-import { Button as FoundationButton } from '../../Button';
-import { Text as FoundationText } from '../../Text';
-import {
-  createRegistries,
-  getCurrentFiber,
-  walkScreen,
-} from '../KitAdoption/utils';
-import type { FiberLike, WalkResult } from '../KitAdoption/types';
-
-/**
- * Production jsx of the React build. Elements made with it carry no
- * `_debugStack`, the same as mini-app code shipped as a prod bundle. Loaded by
- * resolved path: the react `exports` map blocks cjs/ under jest.
- */
-const reactEntry = (
-  require as unknown as { resolve: (id: string) => string }
-).resolve('react');
-const prodJsxRuntime = require(reactEntry.replace(
-  /index\.js$/,
-  'cjs/react-jsx-runtime.production.js',
-)) as {
-  jsx: (
-    type: ElementType,
-    props: Record<string, unknown>,
-  ) => React.ReactElement;
-};
-
-/** Builds an element with the prod jsx runtime, the way a mini-app prod bundle does. */
-const prodJsx = (
-  type: ElementType,
-  props: Record<string, unknown>,
-  ...children: ReactNode[]
-): React.ReactElement => {
-  if (children.length === 0) return prodJsxRuntime.jsx(type, props);
-  return prodJsxRuntime.jsx(type, {
-    ...props,
-    children: children.length > 1 ? children : children[0],
-  });
-};
-
-/** Test-only probe: exposes its fiber so the measurement starts from the real tree. */
-class Probe extends React.Component<{ children?: ReactNode }> {
-  render(): ReactNode {
-    return this.props.children;
-  }
-}
-
-/**
- * Kit registry built from the components this test renders. The full foundation
- * index cannot load under jest (navigation and native-only packages), so it is
- * not used. TouchableOpacity is listed as the foundation re-export, which must not count as kit.
- */
-const registries = createRegistries(
-  [{ Button: FoundationButton, Text: FoundationText }, { TouchableOpacity }],
-  require('react-native') as Record<string, unknown>,
-);
-
-/** Renders the tree under a Probe and walks the probe's child, as AdoptionProbe does. */
-const measure = (tree: ReactNode): WalkResult => {
-  let instance: Probe | null = null;
-  let renderer: ReactTestRenderer | undefined;
-  act(() => {
-    renderer = create(
-      <Probe
-        ref={(value: Probe | null) => {
-          instance = value;
-        }}
-      >
-        {tree}
-      </Probe>,
-    );
-  });
-  const fiber = (instance as unknown as { _reactInternals: FiberLike })
-    ._reactInternals;
-  const root = getCurrentFiber(fiber).child;
-  if (!root) throw new Error('probe rendered no child fiber');
-  const result = walkScreen(root, registries);
-  act(() => {
-    renderer?.unmount();
-  });
-  return result;
-};
-
-/** Shorthand for the K/R/O triple the demo screen prints. */
-const kro = (result: WalkResult): string =>
-  `K${result.counts.K} R${result.counts.R} O${result.counts.O}`;
-
-describe('KitAdoption integration (prod-built app tree over dev host)', () => {
-  it('a. kit-only tree: kit components counted, their internals not', () => {
-    const result = measure(
-      prodJsx(
-        View,
-        {},
-        prodJsx(FoundationText, {}, 'a'),
-        prodJsx(FoundationButton, { title: 'b' }),
-      ),
-    );
-
-    expect(kro(result)).toBe('K2 R1 O0');
-    expect(result.status).toBe('ok');
-    expect(result.kit).toEqual({ Text: 1, Button: 1 });
-  });
-
-  it('b. app wrapper is transparent, each use of the kit inside it is counted', () => {
-    // Two buttons are siblings, so they sit under one dev root, like a real screen.
-    // The probe walks a single root and not its siblings (see walkScreen).
-    function MyButton(props: { title: string }): React.ReactElement {
-      return prodJsx(FoundationButton, props);
-    }
-    function Screen(): React.ReactElement {
-      return prodJsx(
-        Fragment,
-        {},
-        prodJsx(MyButton, { title: '1' }),
-        prodJsx(MyButton, { title: '2' }),
-      );
-    }
-    const result = measure(<Screen />);
-
-    expect(result.counts.K).toBe(2);
-    expect(kro(result)).toBe('K2 R0 O0');
-    expect(result.top_transparent).toEqual([{ name: 'MyButton', count: 2 }]);
-  });
-
-  it('c. raw react-native primitives written by the app count as R', () => {
-    const result = measure(
-      prodJsx(
-        View,
-        {},
-        prodJsx(RNText, {}, 'x'),
-        prodJsx(Image, { source: { uri: 'https://example.com/a.png' } }),
-        prodJsx(TouchableOpacity, {}),
-      ),
-    );
-
-    expect(kro(result)).toBe('K0 R4 O0');
-  });
-
-  it('d. app child in a kit container counts K, the container internals do not', () => {
-    const result = measure(
-      prodJsx(FoundationText, {}, prodJsx(FoundationText, {}, 'child')),
-    );
-
-    expect(kro(result)).toBe('K2 R0 O0');
-    expect(result.kit).toEqual({ Text: 2 });
-  });
-
-  it('e. FlatList counts R once, each renderItem element counts K', () => {
-    const items = ['one', 'two', 'three'];
-    const result = measure(
-      prodJsx(FlatList, {
-        data: items,
-        keyExtractor: (item: string) => item,
-        renderItem: ({ item }: { item: string }) =>
-          prodJsx(FoundationText, {}, item),
-      }),
-    );
-
-    expect(kro(result)).toBe('K3 R1 O0');
-    expect(result.rn).toEqual({ FlatList: 1 });
-  });
-
-  it('f. foundation re-export of TouchableOpacity counts as R, not K', () => {
-    const result = measure(prodJsx(TouchableOpacity, {}, 'x'));
-
-    expect(kro(result)).toBe('K0 R1 O0');
-  });
-
-  it('g. an all-dev tree is reported as dev_bundle', () => {
-    const result = measure(
-      <View>
-        <RNText>x</RNText>
-      </View>,
-    );
-
-    expect(result.status).toBe('dev_bundle');
-    expect(result.counts).toEqual({ K: 0, R: 0, O: 0 });
-    expect(result.fibers).toBeGreaterThan(0);
-  });
-});