@lowdefy/shell 3.23.3 → 7.2.0

package/src/test/expoUi.js

@@ -0,0 +1,55 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import React from 'react';
+import { Text, View } from 'react-native';
+
+// Stand-ins for the @expo/ui controls the native blocks use: @expo/ui draws SwiftUI and Jetpack
+// Compose views through native modules Jest does not have. They keep the props the blocks pass,
+// so a test fires their callbacks with fireEvent(view, 'valueChange', ...).
+function Host({ children }) {
+  return <View>{children}</View>;
+}
+
+function Picker({ children, onValueChange, selectedValue, testID }) {
+  const items = React.Children.toArray(children).map((child) => child.props);
+  return (
+    <View items={items} onValueChange={onValueChange} selectedValue={selectedValue} testID={testID}>
+      {items.map((item) => (
+        <Text key={String(item.value)}>{item.label}</Text>
+      ))}
+    </View>
+  );
+}
+Picker.Item = () => null;
+
+function Switch({ onValueChange, testID, value }) {
+  return <View onValueChange={onValueChange} testID={testID} value={value} />;
+}
+
+function Icon({ color, modifiers, name, size }) {
+  return (
+    <View
+      color={color}
+      modifiers={modifiers}
+      name={name}
+      size={size}
+      testID={`expo-ui-icon-${name}`}
+    />
+  );
+}
+
+export { Host, Icon, Picker, Switch };

package/src/test/expoUiBottomSheet.js

@@ -0,0 +1,64 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import React, { useEffect, useRef } from 'react';
+import { View } from 'react-native';
+
+// A stand-in for @expo/ui's community BottomSheet. It draws its children while `index` is 0 or
+// more, as the native sheet presents them, and keeps its props. As the native sheet, it calls
+// onClose once per dismissal: when index turns -1, or when a test swipes it down with
+// fireEvent(view, 'swipeDismiss').
+function BottomSheet({
+  backgroundStyle,
+  children,
+  enableDynamicSizing,
+  enablePanDownToClose,
+  handleComponent,
+  index,
+  onClose,
+  snapPoints,
+}) {
+  const closed = useRef(index < 0);
+  function fireClose() {
+    if (closed.current) return;
+    closed.current = true;
+    onClose?.();
+  }
+  useEffect(() => {
+    if (index < 0) {
+      fireClose();
+    } else {
+      closed.current = false;
+    }
+  });
+  return (
+    <View
+      backgroundStyle={backgroundStyle}
+      enableDynamicSizing={enableDynamicSizing}
+      enablePanDownToClose={enablePanDownToClose}
+      handleComponent={handleComponent}
+      index={index}
+      onSwipeDismiss={fireClose}
+      snapPoints={snapPoints}
+      testID="expo-ui-bottom-sheet"
+    >
+      {index >= 0 ? children : null}
+    </View>
+  );
+}
+
+export { BottomSheet };
+export default BottomSheet;

package/src/test/expoUiDateTimePicker.js

@@ -0,0 +1,26 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import React from 'react';
+import { View } from 'react-native';
+
+// A stand-in for @expo/ui's community DateTimePicker that keeps the props DateSelector passes.
+function DateTimePicker({ onValueChange, testID, value }) {
+  return <View onValueChange={onValueChange} testID={testID} value={value} />;
+}
+
+export { DateTimePicker };
+export default DateTimePicker;

package/src/test/expoUiMenu.js

@@ -0,0 +1,46 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import React from 'react';
+import { View } from 'react-native';
+
+// A stand-in for @expo/ui's community MenuView that keeps its props, so a test reads the actions
+// it was given and picks one with fireEvent(view, 'pressAction', { nativeEvent: { event: id } }).
+function MenuView({
+  actions,
+  children,
+  onPressAction,
+  shouldOpenOnLongPress,
+  style,
+  testID,
+  title,
+}) {
+  return (
+    <View
+      actions={actions}
+      menuTitle={title}
+      onPressAction={onPressAction}
+      shouldOpenOnLongPress={shouldOpenOnLongPress}
+      style={style}
+      testID={testID}
+    >
+      {children}
+    </View>
+  );
+}
+
+export { MenuView };
+export default MenuView;

package/src/test/expoUiSegmentedControl.js

@@ -0,0 +1,47 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import React from 'react';
+import { View } from 'react-native';
+
+// A stand-in for @expo/ui's community SegmentedControl that keeps its props, so a test picks a
+// segment with fireEvent(view, 'change', { nativeEvent: { selectedSegmentIndex, value } }).
+function SegmentedControl({
+  appearance,
+  enabled = true,
+  onChange,
+  selectedIndex,
+  style,
+  testID,
+  tintColor,
+  values,
+}) {
+  return (
+    <View
+      appearance={appearance}
+      enabled={enabled}
+      onChange={onChange}
+      selectedIndex={selectedIndex}
+      style={style}
+      testID={testID}
+      tintColor={tintColor}
+      values={values}
+    />
+  );
+}
+
+export { SegmentedControl };
+export default SegmentedControl;

package/src/test/expoUiSwiftUi.js

@@ -0,0 +1,62 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import React from 'react';
+import { Pressable, Text, View } from 'react-native';
+
+// Stand-ins for the @expo/ui SwiftUI views the blocks use, which need native modules Jest does not
+// have. ContextMenu draws its trigger, and its items as pressable buttons with the props the
+// block passes, so a test can press an item.
+
+function Host({ children, colorScheme, testID }) {
+  return (
+    <View colorScheme={colorScheme} testID={testID}>
+      {children}
+    </View>
+  );
+}
+
+function Slot({ children }) {
+  return <>{children}</>;
+}
+
+function ContextMenu({ children }) {
+  return <View testID="expo-ui-context-menu">{children}</View>;
+}
+ContextMenu.Items = function Items({ children }) {
+  return <View testID="expo-ui-context-menu-items">{children}</View>;
+};
+ContextMenu.Trigger = Slot;
+ContextMenu.Preview = Slot;
+
+function Button({ label, onPress, role, systemImage }) {
+  return (
+    <Pressable
+      onPress={onPress}
+      role={role}
+      systemImage={systemImage}
+      testID={`expo-ui-button-${label}`}
+    >
+      <Text>{label}</Text>
+    </Pressable>
+  );
+}
+
+function RNHostView({ children }) {
+  return children;
+}
+
+export { Button, ContextMenu, Host, RNHostView };

package/src/test/expoUiSwiftUiModifiers.js

@@ -0,0 +1,23 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+// A stand-in for @expo/ui's SwiftUI modifiers, which reach the ExpoUI native module Jest does not
+// have: each modifier is its name and params, so a test reads what a block asked SwiftUI for.
+function font(params) {
+  return { $type: 'font', ...params };
+}
+
+export { font };

package/src/test/expoWebBrowser.js

@@ -0,0 +1,23 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import { jest } from '@jest/globals';
+
+// A stand-in for expo-web-browser, whose in-app browser needs a native module Jest does not have.
+// A test reads the addresses a block opened from openBrowserAsync's calls.
+const openBrowserAsync = jest.fn(async () => ({ type: 'dismiss' }));
+
+export { openBrowserAsync };

package/src/test/fixtures.js

@@ -0,0 +1,98 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+const typeManifest = {
+  actions: {
+    SetState: { package: '@lowdefy/actions-core', version: 7 },
+  },
+  blocks: {
+    Box: { package: '@lowdefy/blocks-native', version: 7 },
+    Screen: { package: '@lowdefy/blocks-native', version: 7 },
+    Title: { package: '@lowdefy/blocks-native', version: 7 },
+  },
+  operators: {
+    _state: { package: '@lowdefy/operators-js', version: 7 },
+  },
+};
+
+const shell = { version: '7.4.0', typeManifest };
+
+const typeSets = {
+  carried: {
+    actions: [{ type: 'SetState', package: '@lowdefy/actions-core', version: 7 }],
+    blocks: [
+      { type: 'Screen', package: '@lowdefy/blocks-native', version: 7 },
+      { type: 'Title', package: '@lowdefy/blocks-native', version: 7 },
+    ],
+    operators: [{ type: '_state', package: '@lowdefy/operators-js', version: 7 }],
+  },
+  newBlock: {
+    actions: [],
+    blocks: [
+      { type: 'Screen', package: '@lowdefy/blocks-native', version: 7 },
+      { type: 'Map', package: '@lowdefy/blocks-native', version: 7 },
+    ],
+    operators: [],
+  },
+  nextMajor: {
+    actions: [],
+    blocks: [{ type: 'Title', package: '@lowdefy/blocks-native', version: 8 }],
+    operators: [],
+  },
+};
+
+function createPage(pageId, title = pageId) {
+  return {
+    id: `page:${pageId}`,
+    pageId,
+    blockId: pageId,
+    type: 'Screen',
+    properties: { title },
+    slots: { content: { blocks: [{ id: `block:${pageId}:t:0`, blockId: 't', type: 'Title' }] } },
+  };
+}
+
+function createRoot({ buildId = 'build-1', minShellVersion = null, pageIndex, ...rest } = {}) {
+  return {
+    events: {},
+    homePageId: 'today',
+    lowdefyApp: { slug: 'field', buildId },
+    lowdefyGlobal: {},
+    menus: {
+      tabs: [
+        { pageId: 'today', title: 'Today' },
+        { pageId: 'jobs', title: 'Jobs' },
+      ],
+    },
+    minShellVersion,
+    pageIndex: pageIndex ?? [
+      { path: 'today', pageId: 'today', hash: 'h-today-1', typesKey: 'carried' },
+      { path: 'jobs', pageId: 'jobs', hash: 'h-jobs-1', typesKey: 'carried' },
+      { path: 'jobs/{job_id}', pageId: 'job', hash: 'h-job-1', typesKey: 'carried' },
+    ],
+    typeSets,
+    theme: { light: {}, dark: {} },
+    ...rest,
+  };
+}
+
+function createPages(paths) {
+  return Object.fromEntries(
+    paths.map(([path, pageId, etag]) => [path, { pageConfig: createPage(pageId), etag }])
+  );
+}
+
+export { createPage, createPages, createRoot, shell, typeManifest, typeSets };

package/src/test/nativeModule.js

@@ -0,0 +1,33 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+// A stand-in for a native module Jest has no native side for (expo-haptics, expo-location,
+// expo-maps, react-native-nfc-manager, ...): every export is a function that resolves to
+// undefined, so the shell's device features can be built in tests. Tests that exercise a feature
+// install their own fakes in the device registry.
+function stub() {
+  return Promise.resolve(undefined);
+}
+
+module.exports = new Proxy(
+  {},
+  {
+    get(target, key) {
+      if (key === '__esModule') return true;
+      return stub;
+    },
+  }
+);

package/src/test/renderPageScreen.js

@@ -0,0 +1,109 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import React from 'react';
+import { jest } from '@jest/globals';
+import { render } from '@testing-library/react-native';
+
+import createAppSession from '../session/createAppSession.js';
+import createCoreAuth from '../auth/createCoreAuth.js';
+import createFakeServer from './createFakeServer.js';
+import createMemoryCacheStore from './createMemoryCacheStore.js';
+import createMemoryStore from '../host/createMemoryStore.js';
+import createShellGlobals from '../host/createShellGlobals.js';
+import createShellLocale from '../locale/createShellLocale.js';
+import PageScreen from '../components/PageScreen.js';
+import ShellContext from '../ShellContext.js';
+import ShellThemeProvider from '../components/ShellThemeProvider.js';
+import { shell } from './fixtures.js';
+
+const apiBase = 'https://field.example.com';
+
+/**
+ * Renders a PageScreen at `path` as the shell does: one app's session synced with a fake server
+ * holding `root` and `pages` ({ [path]: { pageConfig, etag } }), its host with the shell's
+ * globals over in-memory stores, its locale, and the shell's theme provider. The test file mocks
+ * expo-router.
+ */
+async function renderPageScreen({
+  beforeRender = () => undefined,
+  deviceLocales = ['en-US'],
+  pages,
+  path,
+  query,
+  root,
+}) {
+  const server = createFakeServer({ root, rootEtag: '"r1"', pages });
+  const session = createAppSession({
+    apiBase,
+    app: { id: 'field' },
+    cacheStore: createMemoryCacheStore(),
+    fetch: server.fetch,
+    kv: createMemoryStore(),
+    tokenStore: { get: () => null },
+  });
+  await session.start();
+  const storage = createMemoryStore();
+  const clipboard = { setString: jest.fn(async () => undefined) };
+  const globals = createShellGlobals({
+    assign: jest.fn(),
+    clipboard,
+    fetch: server.fetch,
+    getInstanceId: session.getCurrentInstanceId,
+    getPath: session.getCurrentPath,
+    origin: apiBase,
+    storage,
+  });
+  const host = {
+    authTransport: 'bearer',
+    fetch: server.fetch,
+    globals,
+    onBuildChanged: jest.fn(),
+    onCallerChanged: jest.fn(),
+    router: { back: jest.fn(), push: jest.fn(), replace: jest.fn() },
+    sessionStorage: createMemoryStore(),
+    storage,
+    streamFetch: server.fetch,
+    tokenStore: { get: () => null, set: jest.fn(), clear: jest.fn() },
+    WebSocket: jest.fn(),
+    websocketUrl: (apiPath) => apiPath.replace(/^http/, 'ws'),
+  };
+  const locale = createShellLocale({
+    getDeviceLocales: () => deviceLocales,
+    globals,
+    session,
+    storage,
+  });
+  const auth = {
+    coreAuth: createCoreAuth({
+      apiBase,
+      fetch: server.fetch,
+      getSession: () => session,
+      tokenStore: host.tokenStore,
+    }),
+  };
+  beforeRender({ session });
+  await render(
+    <ShellContext.Provider value={{ auth, host, locale, session, shell }}>
+      <ShellThemeProvider>
+        <PageScreen path={path} query={query} />
+      </ShellThemeProvider>
+    </ShellContext.Provider>
+  );
+  return { clipboard, host, locale, server, session, storage };
+}
+
+export default renderPageScreen;

package/src/types/checkTypeSet.js

@@ -0,0 +1,39 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+const CATEGORIES = ['actions', 'blocks', 'operators'];
+
+// The types of a page's type set (from the mobile root) this shell cannot render: each one the
+// manifest lacks, or carries from another package or another major version of it. A page renders
+// only when this is empty.
+function checkTypeSet({ manifest, typeSet }) {
+  const missing = [];
+  CATEGORIES.forEach((category) => {
+    (typeSet[category] ?? []).forEach((needed) => {
+      const carried = manifest[category]?.[needed.type];
+      if (
+        carried === undefined ||
+        carried.package !== needed.package ||
+        carried.version !== needed.version
+      ) {
+        missing.push({ category, ...needed });
+      }
+    });
+  });
+  return missing;
+}
+
+export default checkTypeSet;

package/src/types/collectPageTypes.js

@@ -0,0 +1,49 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import { serializer, type } from '@lowdefy/helpers';
+
+function collectEventActions({ events, actions }) {
+  Object.values(events ?? {}).forEach((event) => {
+    [...(event?.try ?? []), ...(event?.catch ?? [])].forEach((action) => {
+      if (type.isString(action?.type)) actions.add(action.type);
+    });
+  });
+}
+
+function collectBlock({ block, blocks, actions }) {
+  if (type.isString(block.type)) blocks.add(block.type);
+  collectEventActions({ events: block.events, actions });
+  Object.values(block.slots ?? {}).forEach((slot) => {
+    (slot.blocks ?? []).forEach((child) => collectBlock({ block: child, blocks, actions }));
+  });
+}
+
+// The block and action types a page uses, read from its config. The dev server builds pages on
+// demand and sends no type set, so a dev shell checks a page's types when the page arrives, by
+// name only: a dev shell runs the same Lowdefy version as the dev server. Page config arrives
+// serialized (arrays as `{ '~arr': [...] }`), so it is deserialized before it is walked.
+function collectPageTypes(pageConfig) {
+  const blocks = new Set();
+  const actions = new Set();
+  collectBlock({ block: serializer.deserialize(pageConfig), blocks, actions });
+  return {
+    blocks: [...blocks].sort(),
+    actions: [...actions].sort(),
+  };
+}
+
+export default collectPageTypes;