@forge/react 11.8.3-next.0 → 11.9.0-next.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @forge/react
 
+## 11.9.0-next.1
+
+### Minor Changes
+
+- 92c8fe8: Added useTheme hook to access the current theme and subscribe to theme updates
+
 ## 11.8.3-next.0
 
 ### Patch Changes

package/out/hooks/__test__/useConfig.test.js

@@ -2,23 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const jsx_runtime_1 = require("react/jsx-runtime");
-const listeners = new Map();
-const simpleBridgeEvents = {
-    on: (event, callback) => {
-        if (!listeners.has(event)) {
-            listeners.set(event, []);
-        }
-        listeners.get(event)?.push(callback);
-    },
-    emit: (event, data) => {
-        if (listeners.has(event)) {
-            listeners.get(event)?.forEach((callback) => callback(data));
-        }
-    },
-    clearListeners: (event) => {
-        listeners.delete(event);
-    }
-};
+const utils_1 = require("./utils");
 // defining mock function above import so it is initialised before jest.mock runs
 const mockGetContext = jest.fn(async () => null);
 const react_1 = tslib_1.__importStar(require("react"));
@@ -29,7 +13,7 @@ jest.mock('@forge/bridge', () => ({
     view: {
         getContext: mockGetContext
     },
-    events: simpleBridgeEvents
+    events: utils_1.simpleBridgeEvents
 }));
 const MOCK_CONFIG = {
     value: 1
@@ -59,7 +43,7 @@ const renderTest = async () => {
 };
 describe('useConfig', () => {
     beforeAll(() => (0, testUtils_1.setupBridge)());
-    beforeEach(() => simpleBridgeEvents.clearListeners('FORGE_CORE_MACRO_CONFIG_CHANGED'));
+    beforeEach(() => utils_1.simpleBridgeEvents.clearListeners('FORGE_CORE_MACRO_CONFIG_CHANGED'));
     afterEach(() => jest.clearAllMocks());
     it('correctly outputs a given config', async () => {
         mockGetContext.mockResolvedValue(MOCK_CONTEXT_WITH_CONFIG);
@@ -78,7 +62,7 @@ describe('useConfig', () => {
         await renderTest();
         expect(mockGetContext).toHaveBeenCalledTimes(1);
         const newConfig = { value: 2 };
-        simpleBridgeEvents.emit('FORGE_CORE_MACRO_CONFIG_CHANGED', newConfig);
+        utils_1.simpleBridgeEvents.emit('FORGE_CORE_MACRO_CONFIG_CHANGED', newConfig);
         expect(mockGetContext).toHaveBeenCalledTimes(2);
     });
 });

package/out/hooks/__test__/useObjectStore.test.js

@@ -17,6 +17,7 @@ const mockGetMetadata = jest.fn();
 const reconcilerTestRenderer_1 = tslib_1.__importDefault(require("../../__test__/reconcilerTestRenderer"));
 const testUtils_1 = require("../../__test__/testUtils");
 const useObjectStore_1 = require("../useObjectStore");
+const utils_1 = require("./utils");
 // Mock @forge/bridge
 jest.mock('@forge/bridge', () => ({
     objectStore: {
@@ -170,7 +171,7 @@ describe('useObjectStore', () => {
                 objects: [MOCK_BLOB]
             });
             // Give a tick for state to update
-            await new Promise((resolve) => setTimeout(resolve, 0));
+            await (0, utils_1.sleep)();
             // Should have temp object with isUploading: true
             expect(hookResult.objectStates).toHaveLength(1);
             expect(hookResult.objectStates[0].isUploading).toBe(true);
@@ -278,7 +279,7 @@ describe('useObjectStore', () => {
                 keys: [MOCK_OBJECT_KEY_1]
             });
             // Give a tick for state to update
-            await new Promise((resolve) => setTimeout(resolve, 0));
+            await (0, utils_1.sleep)();
             // Should have isDeleting: true
             expect(hookResult.objectStates[0].isDeleting).toBe(true);
             // Resolve delete
@@ -361,7 +362,7 @@ describe('useObjectStore', () => {
                 keys: [MOCK_OBJECT_KEY_1, MOCK_OBJECT_KEY_2]
             });
             // Give a tick for state to update
-            await new Promise((resolve) => setTimeout(resolve, 0));
+            await (0, utils_1.sleep)();
             // Both should have isDeleting: true
             expect(hookResult.objectStates[0].isDeleting).toBe(true);
             expect(hookResult.objectStates[1].isDeleting).toBe(true);
@@ -418,7 +419,7 @@ describe('useObjectStore', () => {
                 keys: [MOCK_OBJECT_KEY_1]
             });
             // Give a tick for state to update
-            await new Promise((resolve) => setTimeout(resolve, 0));
+            await (0, utils_1.sleep)();
             // Should have isDownloading: true
             expect(hookResult.objectStates[0].isDownloading).toBe(true);
             // Resolve download

package/out/hooks/__test__/useTheme.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useTheme.test.d.ts.map

package/out/hooks/__test__/useTheme.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.test.d.ts","sourceRoot":"","sources":["../../../src/hooks/__test__/useTheme.test.tsx"],"names":[],"mappings":""}

package/out/hooks/__test__/useTheme.test.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const jsx_runtime_1 = require("react/jsx-runtime");
+const utils_1 = require("./utils");
+// defining mock function above import so it is initialised before jest.mock runs
+const mockGetContext = jest.fn(async () => null);
+const react_1 = tslib_1.__importStar(require("react"));
+const reconcilerTestRenderer_1 = tslib_1.__importDefault(require("../../__test__/reconcilerTestRenderer"));
+const useTheme_1 = require("../useTheme");
+const testUtils_1 = require("../../__test__/testUtils");
+jest.mock('@forge/bridge', () => ({
+    view: {
+        getContext: mockGetContext
+    },
+    events: utils_1.simpleBridgeEvents
+}));
+const MOCK_THEME = {
+    colorMode: 'dark',
+    colorScheme: 'blue'
+};
+const MOCK_CONTEXT_WITH_THEME = {
+    theme: MOCK_THEME
+};
+const MOCK_CONTEXT_NO_THEME = {
+    extension: {}
+};
+const themeListener = jest.fn();
+// react app fragment to load useTheme hook
+const renderTest = async () => {
+    const Test = () => {
+        const theme = (0, useTheme_1.useTheme)();
+        (0, react_1.useEffect)(() => themeListener(theme), [theme]);
+        return (0, jsx_runtime_1.jsx)(react_1.default.Fragment, {});
+    };
+    const { update } = await reconcilerTestRenderer_1.default.create((0, jsx_runtime_1.jsx)(Test, {}));
+    return {
+        update: async () => {
+            await update((0, jsx_runtime_1.jsx)(Test, {}));
+        }
+    };
+};
+describe('useTheme', () => {
+    beforeAll(() => (0, testUtils_1.setupBridge)());
+    beforeEach(() => {
+        utils_1.simpleBridgeEvents.clearListeners('FORGE_CORE_THEME_CHANGED');
+        themeListener.mockClear();
+    });
+    afterEach(() => jest.clearAllMocks());
+    it('correctly outputs a given theme', async () => {
+        mockGetContext.mockResolvedValue(MOCK_CONTEXT_WITH_THEME);
+        await renderTest();
+        expect(themeListener).toHaveBeenCalledWith(expect.objectContaining(MOCK_THEME));
+    });
+    it('when there is no theme, outputs null', async () => {
+        mockGetContext.mockResolvedValue(MOCK_CONTEXT_NO_THEME);
+        await renderTest();
+        expect(themeListener).toHaveBeenCalledWith(null);
+    });
+    it('when theme is updated via event, outputs new theme', async () => {
+        mockGetContext.mockResolvedValue(MOCK_CONTEXT_WITH_THEME);
+        await renderTest();
+        expect(themeListener).toHaveBeenCalledWith(expect.objectContaining(MOCK_THEME));
+        const newTheme = { colorMode: 'light', colorScheme: 'red' };
+        utils_1.simpleBridgeEvents.emit('FORGE_CORE_THEME_CHANGED', { theme: newTheme });
+        await (0, utils_1.sleep)();
+        expect(themeListener).toHaveBeenCalledWith(expect.objectContaining(newTheme));
+    });
+    it('does not cause re-render when theme content is the same', async () => {
+        mockGetContext.mockResolvedValue(MOCK_CONTEXT_WITH_THEME);
+        await renderTest();
+        expect(themeListener).toHaveBeenCalledTimes(2); // undefined, then theme
+        // Emit same theme content but different object reference
+        utils_1.simpleBridgeEvents.emit('FORGE_CORE_THEME_CHANGED', {
+            theme: { ...MOCK_THEME } // New object, same content
+        });
+        // Should not trigger re-render due to isEqual check
+        expect(themeListener).toHaveBeenCalledTimes(2);
+    });
+    it('handles event firing before getContext completes', async () => {
+        // eslint-disable-next-line @typescript-eslint/no-empty-function
+        let resolveGetContext = () => { };
+        const getContextPromise = new Promise((resolve) => {
+            resolveGetContext = resolve;
+        });
+        mockGetContext.mockReturnValue(getContextPromise);
+        const renderPromise = renderTest();
+        // Fire event before getContext resolves
+        const eventTheme = { colorMode: 'light', colorScheme: 'green' };
+        utils_1.simpleBridgeEvents.emit('FORGE_CORE_THEME_CHANGED', { theme: eventTheme });
+        // Now resolve getContext
+        resolveGetContext?.(MOCK_CONTEXT_WITH_THEME);
+        await renderPromise;
+        // Should have the event theme, not the getContext theme
+        expect(themeListener).toHaveBeenCalledWith(expect.objectContaining(eventTheme));
+    });
+});

package/out/hooks/__test__/utils.d.ts

@@ -0,0 +1,9 @@
+export declare const simpleBridgeEvents: {
+    on: (event: string, callback: Function) => Promise<{
+        unsubscribe: () => void;
+    }>;
+    emit: (event: string, data?: unknown) => void;
+    clearListeners: (event: string) => void;
+};
+export declare const sleep: () => Promise<unknown>;
+//# sourceMappingURL=utils.d.ts.map

package/out/hooks/__test__/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/hooks/__test__/utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB;gBACjB,MAAM,YAAY,QAAQ;;;kBAiBxB,MAAM,SAAS,OAAO;4BAKZ,MAAM;CAG/B,CAAC;AAGF,eAAO,MAAM,KAAK,wBAAyD,CAAC"}

package/out/hooks/__test__/utils.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = exports.simpleBridgeEvents = void 0;
+const listeners = new Map();
+exports.simpleBridgeEvents = {
+    on: (event, callback) => {
+        if (!listeners.has(event)) {
+            listeners.set(event, []);
+        }
+        listeners.get(event)?.push(callback);
+        return Promise.resolve({
+            unsubscribe: () => {
+                const eventListeners = listeners.get(event);
+                if (eventListeners) {
+                    const index = eventListeners.indexOf(callback);
+                    if (index > -1) {
+                        eventListeners.splice(index, 1);
+                    }
+                }
+            }
+        });
+    },
+    emit: (event, data) => {
+        if (listeners.has(event)) {
+            listeners.get(event)?.forEach((callback) => callback(data));
+        }
+    },
+    clearListeners: (event) => {
+        listeners.delete(event);
+    }
+};
+// Give a tick for state to update
+const sleep = () => new Promise((resolve) => setTimeout(resolve, 0));
+exports.sleep = sleep;

package/out/hooks/useTheme.d.ts

@@ -0,0 +1,5 @@
+import { type FullContext } from '@forge/bridge';
+declare type Theme = FullContext['theme'];
+export declare const useTheme: () => Theme | null;
+export {};
+//# sourceMappingURL=useTheme.d.ts.map

package/out/hooks/useTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../src/hooks/useTheme.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,KAAK,WAAW,EAAQ,MAAM,eAAe,CAAC;AAG/D,aAAK,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAElC,eAAO,MAAM,QAAQ,QAAO,KAAK,GAAG,IAgCnC,CAAC"}

package/out/hooks/useTheme.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTheme = void 0;
+const tslib_1 = require("tslib");
+const react_1 = require("react");
+const bridge_1 = require("@forge/bridge");
+const isEqual_1 = tslib_1.__importDefault(require("lodash/isEqual"));
+const useTheme = () => {
+    const [theme, setTheme] = (0, react_1.useState)(null);
+    const themeLoadedRef = (0, react_1.useRef)(false);
+    (0, react_1.useEffect)(() => {
+        void (async () => {
+            if (!themeLoadedRef.current) {
+                const context = await bridge_1.view.getContext();
+                if (context?.theme && !themeLoadedRef.current) {
+                    setTheme((currentTheme) => {
+                        return (0, isEqual_1.default)(currentTheme, context.theme) ? currentTheme : context.theme;
+                    });
+                    themeLoadedRef.current = true;
+                }
+            }
+        })();
+    }, []);
+    (0, react_1.useEffect)(() => {
+        const sub = bridge_1.events.on('FORGE_CORE_THEME_CHANGED', ({ theme: updatedTheme }) => {
+            themeLoadedRef.current = true;
+            setTheme((currentTheme) => {
+                return (0, isEqual_1.default)(currentTheme, updatedTheme) ? currentTheme : updatedTheme;
+            });
+        });
+        return () => {
+            void sub.then((subscription) => subscription.unsubscribe());
+        };
+    }, []);
+    return theme;
+};
+exports.useTheme = useTheme;

package/out/index.d.ts

@@ -2,6 +2,7 @@ import type { XCSSObject } from './package-types';
 export declare const xcss: (style: XCSSObject) => XCSSObject;
 export { useProductContext } from './hooks/useProductContext';
 export { useConfig } from './hooks/useConfig';
+export { useTheme } from './hooks/useTheme';
 export { usePermissions, type Permissions, type PermissionRequirements, type MissingPermissions, type PermissionCheckResult } from './hooks/usePermissions';
 export { ForgeReconciler as default } from './reconciler';
 export * from './components';

package/out/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,eAAO,MAAM,IAAI,UAAW,UAAU,KAAG,UAAmB,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAE1D,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,+BAA+B,EAAE,MAAM,oDAAoD,CAAC;AACrG,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAClE,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,UAAU,EACV,eAAe,EACf,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,UAAU,EACV,yBAAyB,EACzB,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,SAAS,EACT,aAAa,EACb,QAAQ,EACR,SAAS,EACT,aAAa,EACb,cAAc,EACd,WAAW,EACX,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,4BAA4B,EAC5B,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,aAAa,EACb,gBAAgB,EACjB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,eAAO,MAAM,IAAI,UAAW,UAAU,KAAG,UAAmB,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAE1D,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,+BAA+B,EAAE,MAAM,oDAAoD,CAAC;AACrG,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAClE,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,UAAU,EACV,eAAe,EACf,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,UAAU,EACV,yBAAyB,EACzB,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,SAAS,EACT,aAAa,EACb,QAAQ,EACR,SAAS,EACT,aAAa,EACb,cAAc,EACd,WAAW,EACX,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,4BAA4B,EAC5B,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,aAAa,EACb,gBAAgB,EACjB,MAAM,6BAA6B,CAAC"}

package/out/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useObjectStore = exports.useForm = exports.replaceUnsupportedDocumentNodes = exports.I18nProvider = exports.useTranslation = exports.useIssueProperty = exports.useSpaceProperty = exports.useContentProperty = exports.default = exports.usePermissions = exports.useConfig = exports.useProductContext = exports.xcss = void 0;
+exports.useObjectStore = exports.useForm = exports.replaceUnsupportedDocumentNodes = exports.I18nProvider = exports.useTranslation = exports.useIssueProperty = exports.useSpaceProperty = exports.useContentProperty = exports.default = exports.usePermissions = exports.useTheme = exports.useConfig = exports.useProductContext = exports.xcss = void 0;
 const tslib_1 = require("tslib");
 const xcss = (style) => style;
 exports.xcss = xcss;
@@ -8,6 +8,8 @@ var useProductContext_1 = require("./hooks/useProductContext");
 Object.defineProperty(exports, "useProductContext", { enumerable: true, get: function () { return useProductContext_1.useProductContext; } });
 var useConfig_1 = require("./hooks/useConfig");
 Object.defineProperty(exports, "useConfig", { enumerable: true, get: function () { return useConfig_1.useConfig; } });
+var useTheme_1 = require("./hooks/useTheme");
+Object.defineProperty(exports, "useTheme", { enumerable: true, get: function () { return useTheme_1.useTheme; } });
 var usePermissions_1 = require("./hooks/usePermissions");
 Object.defineProperty(exports, "usePermissions", { enumerable: true, get: function () { return usePermissions_1.usePermissions; } });
 var reconciler_1 = require("./reconciler");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forge/react",
-  "version": "11.8.3-next.0",
+  "version": "11.9.0-next.1",
   "description": "Forge React reconciler",
   "author": "Atlassian",
   "license": "SEE LICENSE IN LICENSE.txt",