Merge branch 'main' into reporting/move-error-codes-to-output

docs/developer/plugin-list.asciidoc

@@ -238,9 +238,9 @@ oss plugins.
 |The service exposed by this plugin informs consumers whether they should optimize for non-interactivity. In this way plugins can avoid loading unnecessary code, data or other services.
 
 
-|{kib-repo}blob/{branch}/src/plugins/share/README.md[share]
+|{kib-repo}blob/{branch}/src/plugins/share/README.mdx[share]
 |The share plugin contains various utilities for displaying sharing context menu,
-generating deep links to other apps, and creating short URLs.
+generating deep links to other apps using locators, and creating short URLs.
 
 
 |{kib-repo}blob/{branch}/src/plugins/shared_ux/README.md[sharedUX]

docs/user/security/session-management.asciidoc

@@ -6,7 +6,7 @@ When you log in, {kib} creates a session that is used to authenticate subsequent
 
 When your session expires, or you log out, {kib} will invalidate your cookie and remove session information from the index. {kib} also periodically invalidates and removes any expired sessions that weren't explicitly invalidated.
 
-To manage user sessions programmatically, {kib} exposes <<session-management-api, session management APIs>>.
+To manage user sessions programmatically, {kib} exposes <<session-management-api, session management APIs>>. For details, check out <<security-session-and-cookie-settings, Session and cookie security settings>>.
 
 [[session-idle-timeout]]
 ==== Session idle timeout

examples/share_examples/README.md

@@ -0,0 +1,3 @@
+# Share plugin examples
+
+Small demos of share plugin usage.

examples/share_examples/kibana.json

@@ -0,0 +1,14 @@
+{
+  "id": "shareExamples",
+  "kibanaVersion": "kibana",
+  "version": "0.0.1",
+  "server": false,
+  "ui": true,
+  "owner": {
+    "name": "App Services",
+    "githubTeam": "kibana-app-services"
+  },
+  "description": "Small demos of share plugin usage",
+  "requiredPlugins": ["share"],
+  "optionalPlugins": []
+}

examples/share_examples/public/index.ts

@@ -0,0 +1,11 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+import { ShareDemoPlugin } from './plugin';
+
+export const plugin = () => new ShareDemoPlugin();

examples/share_examples/public/plugin.tsx

@@ -0,0 +1,42 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+import { SharePluginStart, SharePluginSetup } from '../../../src/plugins/share/public';
+import { Plugin, CoreSetup, CoreStart } from '../../../src/core/public';
+
+interface SetupDeps {
+  share: SharePluginSetup;
+}
+
+interface StartDeps {
+  share: SharePluginStart;
+}
+
+export class ShareDemoPlugin implements Plugin<void, void, SetupDeps, StartDeps> {
+  public setup(core: CoreSetup<StartDeps>, { share }: SetupDeps) {
+    share.register({
+      id: 'demo',
+      getShareMenuItems: (context) => [
+        {
+          panel: {
+            id: 'demo',
+            title: 'Panel title',
+            content: 'Panel content',
+          },
+          shareMenuItem: {
+            name: 'Demo list item (from share_example plugin)',
+          },
+        },
+      ],
+    });
+  }
+
+  public start(core: CoreStart, { share }: StartDeps) {}
+
+  public stop() {}
+}

examples/share_examples/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./target/types"
+  },
+  "include": [
+    "index.ts",
+    "public/**/*.ts",
+    "public/**/*.tsx",
+    "server/**/*.ts",
+    "../../typings/**/*"
+  ],
+  "exclude": [],
+  "references": [
+    { "path": "../../src/core/tsconfig.json" },
+    { "path": "../../src/plugins/share/tsconfig.json" },
+  ]
+}

nav-kibana-dev.docnav.json

@@ -48,7 +48,8 @@
         },
         { "id": "kibDevTutorialCI" },
         { "id": "kibDevTutorialServerEndpoint" },
-        { "id": "kibDevTutorialAdvancedSettings"}
+        { "id": "kibDevTutorialAdvancedSettings"},
+        { "id": "kibDevSharePluginReadme"}
       ]
     },
     {

packages/kbn-es/jest.config.js

@@ -7,7 +7,7 @@
  */
 
 module.exports = {
-  preset: '@kbn/test',
+  preset: '@kbn/test/jest_node',
   rootDir: '../..',
   roots: ['<rootDir>/packages/kbn-es'],
 };

packages/kbn-es/jest.integration.config.js

@@ -7,7 +7,7 @@
  */
 
 module.exports = {
-  preset: '@kbn/test/jest_integration',
+  preset: '@kbn/test/jest_integration_node',
   rootDir: '../..',
   roots: ['<rootDir>/packages/kbn-es'],
 };

packages/kbn-optimizer/jest.config.js

@@ -7,7 +7,7 @@
  */
 
 module.exports = {
-  preset: '@kbn/test',
+  preset: '@kbn/test/jest_node',
   rootDir: '../..',
   roots: ['<rootDir>/packages/kbn-optimizer'],
 };

packages/kbn-optimizer/jest.integration.config.js

@@ -7,7 +7,7 @@
  */
 
 module.exports = {
-  preset: '@kbn/test/jest_integration',
+  preset: '@kbn/test/jest_integration_node',
   rootDir: '../..',
   roots: ['<rootDir>/packages/kbn-optimizer'],
 };

packages/kbn-plugin-generator/jest.config.js

@@ -7,7 +7,7 @@
  */
 
 module.exports = {
-  preset: '@kbn/test',
+  preset: '@kbn/test/jest_node',
   rootDir: '../..',
   roots: ['<rootDir>/packages/kbn-plugin-generator'],
 };

packages/kbn-plugin-generator/jest.integration.config.js

@@ -7,7 +7,7 @@
  */
 
 module.exports = {
-  preset: '@kbn/test/jest_integration',
+  preset: '@kbn/test/jest_integration_node',
   rootDir: '../..',
   roots: ['<rootDir>/packages/kbn-plugin-generator'],
 };

packages/kbn-plugin-helpers/jest.integration.config.js

@@ -7,7 +7,7 @@
  */
 
 module.exports = {
-  preset: '@kbn/test/jest_integration',
+  preset: '@kbn/test/jest_integration_node',
   rootDir: '../..',
   roots: ['<rootDir>/packages/kbn-plugin-helpers'],
 };

packages/kbn-test/BUILD.bazel

@@ -30,6 +30,8 @@ filegroup(
 NPM_MODULE_EXTRA_FILES = [
   "jest-preset.js",
   "jest_integration/jest-preset.js",
+  "jest_integration_node/jest-preset.js",
+  "jest_node/jest-preset.js",
   "jest.config.js",
   "README.md",
   "package.json",

packages/kbn-test/jest-preset.js

@@ -66,14 +66,15 @@ module.exports = {
   // The paths to modules that run some code to configure or set up the testing environment before each test
   setupFiles: [
     '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/babel_polyfill.js',
-    '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/polyfills.js',
+    '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/polyfills.jsdom.js',
     '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/enzyme.js',
   ],
 
   // A list of paths to modules that run some code to configure or set up the testing framework before each test
   setupFilesAfterEnv: [
     '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/setup_test.js',
-    '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/mocks.js',
+    '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/mocks.moment_timezone.js',
+    '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/mocks.eui.js',
     '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/react_testing_library.js',
   ],
 

packages/kbn-test/jest.config.js

@@ -7,7 +7,7 @@
  */
 
 module.exports = {
-  preset: '@kbn/test',
+  preset: '@kbn/test/jest_node',
   rootDir: '../..',
   roots: ['<rootDir>/packages/kbn-test'],
 };

packages/kbn-test/jest.integration.config.js

@@ -7,7 +7,7 @@
  */
 
 module.exports = {
-  preset: '@kbn/test/jest_integration',
+  preset: '@kbn/test/jest_integration_node',
   rootDir: '../..',
   roots: ['<rootDir>/packages/kbn-test'],
 };

packages/kbn-test/jest_integration/jest-preset.js

@@ -16,7 +16,8 @@ module.exports = {
   ),
   setupFilesAfterEnv: [
     '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/after_env.integration.js',
-    '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/mocks.js',
+    '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/mocks.moment_timezone.js',
+    '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/mocks.eui.js',
   ],
   reporters: [
     'default',

packages/kbn-test/jest_integration_node/jest-preset.js

@@ -0,0 +1,46 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+const preset = require('../jest-preset');
+
+/** @typedef {import("@jest/types").Config.InitialOptions} JestConfig */
+/** @type {JestConfig} */
+module.exports = {
+  ...preset,
+  testMatch: ['**/integration_tests**/*.test.{js,mjs,ts,tsx}'],
+  testPathIgnorePatterns: preset.testPathIgnorePatterns.filter(
+    (pattern) => !pattern.includes('integration_tests')
+  ),
+  setupFilesAfterEnv: [
+    '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/after_env.integration.js',
+    '<rootDir>/node_modules/@kbn/test/target_node/jest/setup/mocks.moment_timezone.js',
+  ],
+  reporters: [
+    'default',
+    [
+      '@kbn/test/target_node/jest/junit_reporter',
+      {
+        rootDirectory: '.',
+        reportName: 'Jest Integration Tests',
+      },
+    ],
+    [
+      '@kbn/test/target_node/jest/ci_stats_jest_reporter',
+      {
+        testGroupType: 'Jest Integration Tests',
+      },
+    ],
+  ],
+  coverageReporters: !!process.env.CI
+    ? [['json', { file: 'jest-integration.json' }]]
+    : ['html', 'text'],
+
+  testEnvironment: 'node',
+  snapshotSerializers: [],
+  setupFiles: ['<rootDir>/node_modules/@kbn/test/target_node/jest/setup/babel_polyfill.js'],
+};

packages/kbn-test/jest_node/jest-preset.js

@@ -0,0 +1,16 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+const preset = require('../jest-preset');
+
+module.exports = {
+  ...preset,
+  testEnvironment: 'node',
+  snapshotSerializers: [],
+  setupFiles: ['<rootDir>/node_modules/@kbn/test/target_node/jest/setup/babel_polyfill.js'],
+};