@oracle/oraclejet-jest-preset 12.0.0

package/jest-preset.js

@@ -0,0 +1,3 @@
+// This file must be at the root of the package to be able to be used in jest.
+// See https://jestjs.io/docs/en/configuration#preset-string
+module.exports = require('./src/preset');

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@oracle/oraclejet-jest-preset",
+  "version": "12.0.0",
+  "description": "JET preset for Jest testing",
+  "main": "jest-preset.js",
+  "author": "",
+  "license": "UPL-1.0",
+  "dependencies": {
+    "babel-jest": "^27.4.5",
+    "babel-plugin-transform-amd-to-commonjs": "^1.4.0",
+    "css": "^3.0.0",
+    "jest-preset-preact": "^4.0.2",
+    "jest-raw-loader": "^1.0.1",
+    "preact-render-to-string": "^5.1.16"
+  },
+  "peerDependencies": {
+    "jest": "27.x",
+    "@oracle/oraclejet": ">=12.x"
+  },
+  "files": [
+    "*.js",
+    "src/**"
+  ]
+}

package/src/babel.js

@@ -0,0 +1,26 @@
+const { default: babelJest } = require('babel-jest');
+
+module.exports = babelJest.createTransformer({
+	presets: [
+		[
+			'@babel/preset-typescript',
+			{
+				jsxPragma: 'h',
+			},
+		],
+		'@babel/preset-env',
+	],
+	plugins: [
+		'babel-plugin-transform-amd-to-commonjs',
+		[
+			'@babel/plugin-transform-react-jsx',
+			{
+				pragma: 'h',
+				pragmaFrag: 'Fragment',
+			},
+		],
+		'@babel/plugin-proposal-class-properties',
+	],
+	babelrc: false,
+	configFile: false,
+});

package/src/loaders/json-text-loader.js

@@ -0,0 +1,9 @@
+// This loader is to be used when importing a JSON file (as done by CCA's loader.ts)
+// expects that the content will come as text. NodeJS's behavior is to parse JSON
+// files and return the object from the module, causing double-parsing when passed
+// to JSON.parse().
+// This loader escapes the double-quotes so that Node's JSON.parse() treats it
+// as a single string key.
+module.exports = {
+  process: content => `"` + content.replace(/"/g, `\\"`).replace(/\n/g, '') + `"`
+}

package/src/loaders/ojL10n-loader.js

@@ -0,0 +1,45 @@
+// This loader mimics ojL10n's behavior of returning the contents of the 'root'
+// property from JET bundles.
+
+const vm = require('vm');
+
+/*
+ * Create a context in which the resource bundle's script will run.
+ * AMD resource bundles are defined in one of two structures:
+ * - define({ resource_keys... })
+ * - define(['require', 'exports'], function(require, exports) { })
+ *
+ * For the 2nd structure (with callback), the resource bundle can be returned
+ * from the callback or assigned to the "exports" parameter.
+ *
+ * Return the bundle from our define() so that it can be uniformly extracted
+ */
+const context = vm.createContext({
+  define: function(rb) {
+    // define({ ... })
+    if (arguments.length === 1) {
+      return rb;
+    }
+    // define(['require', 'exports'], function(require, exports))
+    const exp = {};
+    // pass exports for every argument
+    const args = new Array(arguments[0].length);
+    const ret = arguments[1](...args.fill(exp));
+    // AMD may return the value or assign to 'exports'
+    const resource = ret || exp;
+    return resource.default || resource;
+  }
+});
+
+module.exports = {
+  process(content, filename) {
+    // "content" is the resource bundle's script source
+    // Since the script runs in our context, assign it to "this.rb" so that we
+    // can retrieve it
+    const script = new vm.Script(`this.rb = ${content}`);
+    script.runInContext(context);
+    // app resource bundles are underneath 'root'
+    // otherwise return entire bundle
+    return `module.exports = ${JSON.stringify(context.rb.root || context.rb)}`;
+  }
+}

package/src/mocks/blank.js

@@ -0,0 +1 @@
+module.exports = {};

package/src/mocks/ojlocaledata.js

@@ -0,0 +1,9 @@
+const LocaleData = require("../../../oraclejet/dist/js/libs/oj/debug/ojlocaledata");
+const rootBundle = require("ojL10n!ojtranslations/nls/localeElements");
+const enBundle = require("ojL10n!ojtranslations/nls/en/localeElements");
+
+Object.assign(enBundle.main.en, rootBundle, {
+  _ojLocale_: "en",
+});
+LocaleData.setBundle(enBundle.main.en);
+module.exports = LocaleData;

package/src/mocks/ojthemeutils.js

@@ -0,0 +1,57 @@
+const css = require('css');
+const fs = require('fs');
+const path = require('path');
+
+let rules;
+let cssVars = [];
+const fontFamilyJsons = {};
+function parseRules() {
+  if (!rules) {
+    const cssPath = path.resolve(__dirname, '../../../oraclejet/dist/css/stable/oj-stable.css');
+    const contents = fs.readFileSync(cssPath).toString();
+    rules = css.parse(contents).stylesheet.rules.filter((rule) => rule.selectors);
+  }
+}
+
+function parseJSONFromFontFamily(className) {
+  parseRules();
+  let config = fontFamilyJsons[className];
+  if (!config) {
+    const selector = `.${className}`;
+    // Find the rule matching selector and declaration with 'font-family'
+    const rule = rules.find(
+      (rule) =>
+        rule.selectors.includes(selector) &&
+        rule.declarations.find((decl) => decl.property === 'font-family')
+    );
+    const ff = rule.declarations.find((decl) => decl.property === 'font-family');
+    // Remove !important and start/ending quotes
+    const ffValue = ff.value.replace(/\s*!important;?/, '').replace(/^'/, '').replace(/'$/, '')
+    config = fontFamilyJsons[className] = JSON.parse(ffValue);
+  }
+  return config;
+}
+
+function getCachedCSSVarValues(names) {
+  parseRules();
+  if (!cssVars.length) {
+    // Find all :root declarations
+    rules.forEach((rule) => {
+      if (rule.selectors.includes(':root')) {
+        cssVars = cssVars.concat(rule.declarations);
+      }
+    });
+  }
+  const matches = cssVars.filter((decl => names.includes(decl.property)));
+  // Remove leading/trailing quotes
+  return matches.map((match) => match.value.replace(/^'/, '').replace(/'$/, ''));
+}
+
+module.exports = {
+  clearCache: function () {},
+  getThemeName: function () {},
+  getThemeTargetPlatform: function () {},
+  parseJSONFromFontFamily,
+  verifyThemeVersion: function () {},
+  getCachedCSSVarValues
+};

package/src/mocks/ojtranslation.js

@@ -0,0 +1,5 @@
+const Translation = require("../../../oraclejet/dist/js/libs/oj/debug/ojtranslation");
+const rootTranslations = require("ojL10n!ojtranslations/nls/ojtranslations");
+
+Translation.setBundle(rootTranslations);
+module.exports = Translation;

package/src/preset.js

@@ -0,0 +1,45 @@
+const jestPreset = require('jest-preset-preact');
+const path = require('path');
+
+const mappedModules = {
+  // Noop style files
+  '^.+\\.(css|sass|scss|less)$': 'identity-obj-proxy',
+  '^css!.*': 'identity-obj-proxy',
+  '^ojcss!.*': 'identity-obj-proxy',
+  // Remove text! prefix and use loaders to transform content to text for things
+  // typically loaded with this plugin (text & html)
+  '^text!(.*)': '$1',
+  // Mock modules
+  touchr: path.resolve(__dirname, 'mocks', 'blank'),
+  ojdnd: path.resolve(__dirname, 'mocks', 'blank'),
+  'ojs/(.*)': [
+    // Resolve ojs/* to any mock modules first
+    path.resolve(__dirname, 'mocks', '$1'),
+    '<rootDir>/node_modules/@oracle/oraclejet/dist/js/libs/oj/debug/$1'
+  ],
+  'ojL10n!./(.*)': './$1',
+  'ojL10n!ojtranslations/nls/(.*)':
+    '<rootDir>/node_modules/@oracle/oraclejet/dist/js/libs/oj/resources/nls/$1',
+  'jqueryui-amd/(.*)':
+    '<rootDir>/node_modules/@oracle/oraclejet/dist/js/libs/jquery/jqueryui-amd-1.13.0/$1'
+};
+
+Object.assign(jestPreset, {
+  modulePaths: ['<rootDir>/node_modules/@oracle/oraclejet/dist/js/libs/oj/'],
+  transform: {
+    'resources\\/nls\\/': require.resolve('./loaders/ojL10n-loader'),
+    // Use our own Babel configuration
+    '^.+\\.(mjs|js|jsx|ts|tsx)$': path.resolve(__dirname, 'babel.js'),
+      // Handle loader.ts which loads component.json and expects string instead of
+    // JSON object
+    'component\\.json$': require.resolve('./loaders/json-text-loader'),
+    '\\.html$': 'jest-raw-loader',
+  },
+  transformIgnorePatterns: [
+    '/node_modules/(?!(@oracle/oraclejet)/)',
+    '^.+\\.(css|sass|scss|less)$'
+  ]
+});
+Object.assign(jestPreset.moduleNameMapper, mappedModules);
+
+module.exports = jestPreset;