@zohodesk/testinglibrary 0.0.9 → 0.0.10-n20-experimental

package/playwright-mcp-test/node_modules/playwright/cli.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * 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 { program } = require('./lib/program');
+program.parse(process.argv);

package/playwright-mcp-test/node_modules/playwright/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * 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.
+ */
+
+export * from 'playwright-core';

package/playwright-mcp-test/node_modules/playwright/index.js

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * 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.
+ */
+
+module.exports = require('playwright-core');

package/playwright-mcp-test/node_modules/playwright/index.mjs

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * 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.
+ */
+export * from 'playwright-core';
+import playwright from 'playwright-core';
+export default playwright;

package/playwright-mcp-test/node_modules/playwright/jsx-runtime.js

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * 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.
+ */
+
+function jsx(type, props, key) {
+  return {
+    __pw_type: 'jsx',
+    type,
+    props,
+    key,
+  };
+}
+
+function jsxs(type, props, key) {
+  return {
+    __pw_type: 'jsx',
+    type,
+    props,
+    key,
+  };
+}
+
+// this is used in <></> notation
+const Fragment = { __pw_jsx_fragment: true };
+
+module.exports = {
+  Fragment,
+  jsx,
+  jsxs,
+};

package/playwright-mcp-test/node_modules/playwright/jsx-runtime.mjs

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * 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 jsxRuntime from './jsx-runtime.js';
+
+export const jsx = jsxRuntime.jsx;
+export const jsxs = jsxRuntime.jsxs;
+export const Fragment = jsxRuntime.Fragment;

package/playwright-mcp-test/node_modules/playwright/lib/agents/generateAgents.js

@@ -0,0 +1,368 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var generateAgents_exports = {};
+__export(generateAgents_exports, {
+  AgentGenerator: () => AgentGenerator,
+  ClaudeGenerator: () => ClaudeGenerator,
+  OpencodeGenerator: () => OpencodeGenerator,
+  VSCodeGenerator: () => VSCodeGenerator
+});
+module.exports = __toCommonJS(generateAgents_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+var import_utils = require("playwright-core/lib/utils");
+var import_seed = require("../mcp/test/seed");
+class AgentParser {
+  static async loadAgents() {
+    const files = await import_fs.default.promises.readdir(__dirname);
+    return Promise.all(files.filter((file) => file.endsWith(".agent.md")).map((file) => AgentParser.parseFile(import_path.default.join(__dirname, file))));
+  }
+  static async parseFile(filePath) {
+    const source = await import_fs.default.promises.readFile(filePath, "utf-8");
+    const { header, content } = this.extractYamlAndContent(source);
+    const { instructions, examples } = this.extractInstructionsAndExamples(content);
+    return { source, header, instructions, examples };
+  }
+  static extractYamlAndContent(markdown) {
+    const lines = markdown.split("\n");
+    if (lines[0] !== "---")
+      throw new Error("Markdown file must start with YAML front matter (---)");
+    let yamlEndIndex = -1;
+    for (let i = 1; i < lines.length; i++) {
+      if (lines[i] === "---") {
+        yamlEndIndex = i;
+        break;
+      }
+    }
+    if (yamlEndIndex === -1)
+      throw new Error("YAML front matter must be closed with ---");
+    const yamlLines = lines.slice(1, yamlEndIndex);
+    const yamlRaw = yamlLines.join("\n");
+    const contentLines = lines.slice(yamlEndIndex + 1);
+    const content = contentLines.join("\n");
+    let header;
+    try {
+      header = import_utilsBundle.yaml.parse(yamlRaw);
+    } catch (error) {
+      throw new Error(`Failed to parse YAML header: ${error.message}`);
+    }
+    if (!header.name)
+      throw new Error('YAML header must contain a "name" field');
+    if (!header.description)
+      throw new Error('YAML header must contain a "description" field');
+    return { header, content };
+  }
+  static extractInstructionsAndExamples(content) {
+    const examples = [];
+    const instructions = content.split("<example>")[0].trim();
+    const exampleRegex = /<example>([\s\S]*?)<\/example>/g;
+    let match;
+    while ((match = exampleRegex.exec(content)) !== null) {
+      const example = match[1].trim();
+      examples.push(example.replace(/[\n]/g, " ").replace(/ +/g, " "));
+    }
+    return { instructions, examples };
+  }
+}
+class ClaudeGenerator {
+  static async init(config, projectName) {
+    await initRepo(config, projectName, {
+      promptsFolder: ".claude/prompts"
+    });
+    const agents = await AgentParser.loadAgents();
+    await import_fs.default.promises.mkdir(".claude/agents", { recursive: true });
+    for (const agent of agents)
+      await writeFile(`.claude/agents/${agent.header.name}.agent.md`, ClaudeGenerator.agentSpec(agent), "\u{1F916}", "agent definition");
+    await writeFile(".mcp.json", JSON.stringify({
+      mcpServers: {
+        "playwright-test": {
+          command: "npx",
+          args: ["playwright", "run-test-mcp-server"]
+        }
+      }
+    }, null, 2), "\u{1F527}", "mcp configuration");
+    initRepoDone();
+  }
+  static agentSpec(agent) {
+    const claudeToolMap = /* @__PURE__ */ new Map([
+      ["search", ["Glob", "Grep"]],
+      ["read", ["Read"]],
+      ["edit", ["Edit", "MultiEdit"]],
+      ["write", ["Write"]]
+    ]);
+    function asClaudeTool(tool) {
+      const [first, second] = tool.split("/");
+      if (!second)
+        return (claudeToolMap.get(first) || [first]).join(", ");
+      return `mcp__${first}__${second}`;
+    }
+    const lines = [];
+    lines.push(`---`);
+    lines.push(`name: ${agent.header.name}`);
+    lines.push(`description: ${agent.header.description}. Examples: ${agent.examples.map((example) => `<example>${example}</example>`).join("")}`);
+    lines.push(`tools: ${agent.header.tools.map((tool) => asClaudeTool(tool)).join(", ")}`);
+    lines.push(`model: ${agent.header.model}`);
+    lines.push(`color: ${agent.header.color}`);
+    lines.push(`---`);
+    lines.push("");
+    lines.push(agent.instructions);
+    return lines.join("\n");
+  }
+}
+class OpencodeGenerator {
+  static async init(config, projectName) {
+    await initRepo(config, projectName, {
+      agentDefault: "Build",
+      promptsFolder: ".opencode/prompts"
+    });
+    const agents = await AgentParser.loadAgents();
+    for (const agent of agents) {
+      const prompt = [agent.instructions];
+      prompt.push("");
+      prompt.push(...agent.examples.map((example) => `<example>${example}</example>`));
+      await writeFile(`.opencode/prompts/${agent.header.name}.agent.md`, prompt.join("\n"), "\u{1F916}", "agent definition");
+    }
+    await writeFile("opencode.json", OpencodeGenerator.configuration(agents), "\u{1F527}", "opencode configuration");
+    initRepoDone();
+  }
+  static configuration(agents) {
+    const opencodeToolMap = /* @__PURE__ */ new Map([
+      ["search", ["ls", "glob", "grep"]],
+      ["read", ["read"]],
+      ["edit", ["edit"]],
+      ["write", ["write"]]
+    ]);
+    const asOpencodeTool = (tools, tool) => {
+      const [first, second] = tool.split("/");
+      if (!second) {
+        for (const tool2 of opencodeToolMap.get(first) || [first])
+          tools[tool2] = true;
+      } else {
+        tools[`${first}*${second}`] = true;
+      }
+    };
+    const result = {};
+    result["$schema"] = "https://opencode.ai/config.json";
+    result["mcp"] = {};
+    result["tools"] = {
+      "playwright*": false
+    };
+    result["agent"] = {};
+    for (const agent of agents) {
+      const tools = {};
+      result["agent"][agent.header.name] = {
+        description: agent.header.description,
+        mode: "subagent",
+        prompt: `{file:.opencode/prompts/${agent.header.name}.agent.md}`,
+        tools
+      };
+      for (const tool of agent.header.tools)
+        asOpencodeTool(tools, tool);
+    }
+    result["mcp"]["playwright-test"] = {
+      type: "local",
+      command: ["npx", "playwright", "run-test-mcp-server"],
+      enabled: true
+    };
+    return JSON.stringify(result, null, 2);
+  }
+}
+class AgentGenerator {
+  static async init(config, projectName) {
+    const agentsFolder = process.env.AGENTS_FOLDER;
+    if (!agentsFolder) {
+      console.error("AGENTS_FOLDER environment variable is not set");
+      return;
+    }
+    await initRepo(config, projectName, {
+      promptsFolder: import_path.default.join(agentsFolder, "prompts")
+    });
+    const agents = await AgentParser.loadAgents();
+    await import_fs.default.promises.mkdir(agentsFolder, { recursive: true });
+    for (const agent of agents)
+      await writeFile(`${agentsFolder}/agents/${agent.header.name}.md`, agent.source, "\u{1F916}", "agent definition");
+    console.log("\u{1F527} MCP configuration");
+    console.log(JSON.stringify({
+      mcpServers: {
+        "playwright-test": {
+          type: "stdio",
+          command: "npx",
+          args: [
+            `--prefix=${import_path.default.resolve(process.cwd())}`,
+            "playwright",
+            "run-test-mcp-server",
+            `--headless`,
+            `--config=${import_path.default.resolve(process.cwd())}`
+          ],
+          tools: ["*"]
+        }
+      }
+    }, null, 2));
+    initRepoDone();
+  }
+}
+class VSCodeGenerator {
+  static async init(config, projectName) {
+    await initRepo(config, projectName, {
+      agentDefault: "agent",
+      agentHealer: "\u{1F3AD} healer",
+      agentGenerator: "\u{1F3AD} generator",
+      agentPlanner: "\u{1F3AD} planner",
+      promptsFolder: ".github/prompts"
+    });
+    const agents = await AgentParser.loadAgents();
+    const nameMap = /* @__PURE__ */ new Map([
+      ["playwright-test-planner", "\u{1F3AD} planner"],
+      ["playwright-test-generator", "\u{1F3AD} generator"],
+      ["playwright-test-healer", "\u{1F3AD} healer"]
+    ]);
+    await deleteFile(`.github/chatmodes/ \u{1F3AD} planner.chatmode.md`, "old planner chatmode");
+    await import_fs.default.promises.mkdir(".github/chatmodes", { recursive: true });
+    for (const agent of agents)
+      await writeFile(`.github/chatmodes/${nameMap.get(agent.header.name)}.chatmode.md`, VSCodeGenerator.agentSpec(agent), "\u{1F916}", "chatmode definition");
+    await import_fs.default.promises.mkdir(".vscode", { recursive: true });
+    const mcpJsonPath = ".vscode/mcp.json";
+    let mcpJson = {
+      servers: {},
+      inputs: []
+    };
+    try {
+      mcpJson = JSON.parse(import_fs.default.readFileSync(mcpJsonPath, "utf8"));
+    } catch {
+    }
+    if (!mcpJson.servers)
+      mcpJson.servers = {};
+    mcpJson.servers["playwright-test"] = {
+      type: "stdio",
+      command: "npx",
+      args: ["playwright", "run-test-mcp-server"]
+    };
+    await writeFile(mcpJsonPath, JSON.stringify(mcpJson, null, 2), "\u{1F527}", "mcp configuration");
+    initRepoDone();
+  }
+  static agentSpec(agent) {
+    const vscodeToolMap = /* @__PURE__ */ new Map([
+      ["search", ["search/listDirectory", "search/fileSearch", "search/textSearch"]],
+      ["read", ["search/readFile"]],
+      ["edit", ["edit/editFiles"]],
+      ["write", ["edit/createFile", "edit/createDirectory"]]
+    ]);
+    const vscodeToolsOrder = ["edit/createFile", "edit/createDirectory", "edit/editFiles", "search/fileSearch", "search/textSearch", "search/listDirectory", "search/readFile"];
+    const vscodeMcpName = "playwright-test";
+    function asVscodeTool(tool) {
+      const [first, second] = tool.split("/");
+      if (second)
+        return `${vscodeMcpName}/${second}`;
+      return vscodeToolMap.get(first) || first;
+    }
+    const tools = agent.header.tools.map(asVscodeTool).flat().sort((a, b) => {
+      const indexA = vscodeToolsOrder.indexOf(a);
+      const indexB = vscodeToolsOrder.indexOf(b);
+      if (indexA === -1 && indexB === -1)
+        return a.localeCompare(b);
+      if (indexA === -1)
+        return 1;
+      if (indexB === -1)
+        return -1;
+      return indexA - indexB;
+    }).map((tool) => `'${tool}'`).join(", ");
+    const lines = [];
+    lines.push(`---`);
+    lines.push(`description: ${agent.header.description}.`);
+    lines.push(`tools: [${tools}]`);
+    lines.push(`---`);
+    lines.push("");
+    lines.push(agent.instructions);
+    for (const example of agent.examples)
+      lines.push(`<example>${example}</example>`);
+    return lines.join("\n");
+  }
+}
+async function writeFile(filePath, content, icon, description) {
+  console.log(`- ${icon} ${import_path.default.relative(process.cwd(), filePath)} ${import_utilsBundle.colors.dim("- " + description)}`);
+  await (0, import_utils.mkdirIfNeeded)(filePath);
+  await import_fs.default.promises.writeFile(filePath, content, "utf-8");
+}
+async function deleteFile(filePath, description) {
+  try {
+    if (!import_fs.default.existsSync(filePath))
+      return;
+  } catch {
+    return;
+  }
+  console.log(`- \u2702\uFE0F  ${import_path.default.relative(process.cwd(), filePath)} ${import_utilsBundle.colors.dim("- " + description)}`);
+  await import_fs.default.promises.unlink(filePath);
+}
+async function initRepo(config, projectName, options) {
+  const project = (0, import_seed.seedProject)(config, projectName);
+  console.log(`\u{1F3AD} Using project "${project.project.name}" as a primary project`);
+  if (!import_fs.default.existsSync("specs")) {
+    await import_fs.default.promises.mkdir("specs");
+    await writeFile(import_path.default.join("specs", "README.md"), `# Specs
+
+This is a directory for test plans.
+`, "\u{1F4DD}", "directory for test plans");
+  }
+  let seedFile = await (0, import_seed.findSeedFile)(project);
+  if (!seedFile) {
+    seedFile = (0, import_seed.defaultSeedFile)(project);
+    await writeFile(seedFile, import_seed.seedFileContent, "\u{1F331}", "default environment seed file");
+  }
+  await import_fs.default.promises.mkdir(options.promptsFolder, { recursive: true });
+  for (const promptFile of await import_fs.default.promises.readdir(__dirname)) {
+    if (!promptFile.endsWith(".prompt.md"))
+      continue;
+    const content = await loadPrompt(promptFile, { ...options, seedFile: import_path.default.relative(process.cwd(), seedFile) });
+    await writeFile(import_path.default.join(options.promptsFolder, promptFile), content, "\u{1F4DD}", "prompt template");
+  }
+}
+function initRepoDone() {
+  console.log("\u2705 Done.");
+}
+async function loadPrompt(file, params) {
+  const templateParams = {
+    agentDefault: params.agentDefault ?? "default",
+    agentHealer: params.agentHealer ?? "playwright-test-healer",
+    agentGenerator: params.agentGenerator ?? "playwright-test-generator",
+    agentPlanner: params.agentPlanner ?? "playwright-test-planner",
+    seedFile: params.seedFile
+  };
+  const content = await import_fs.default.promises.readFile(import_path.default.join(__dirname, file), "utf-8");
+  return Object.entries(templateParams).reduce((acc, [key, value]) => {
+    return acc.replace(new RegExp(`\\\${${key}}`, "g"), value);
+  }, content);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentGenerator,
+  ClaudeGenerator,
+  OpencodeGenerator,
+  VSCodeGenerator
+});

package/playwright-mcp-test/node_modules/playwright/lib/agents/generator.agent.md

@@ -0,0 +1,101 @@
+---
+name: playwright-test-generator
+description: Use this agent when you need to create automated browser tests using Playwright
+model: sonnet
+color: blue
+tools:
+  - read
+  - search
+  - playwright-test/browser_click
+  - playwright-test/browser_drag
+  - playwright-test/browser_evaluate
+  - playwright-test/browser_file_upload
+  - playwright-test/browser_handle_dialog
+  - playwright-test/browser_hover
+  - playwright-test/browser_navigate
+  - playwright-test/browser_press_key
+  - playwright-test/browser_select_option
+  - playwright-test/browser_snapshot
+  - playwright-test/browser_type
+  - playwright-test/browser_verify_element_visible
+  - playwright-test/browser_verify_list_visible
+  - playwright-test/browser_verify_text_visible
+  - playwright-test/browser_verify_value
+  - playwright-test/browser_wait_for
+  - playwright-test/generator_read_log
+  - playwright-test/generator_setup_page
+  - playwright-test/generator_write_test
+---
+
+You are a Playwright Test Generator, an expert in browser automation and end-to-end testing.
+Your specialty is creating robust, reliable Playwright tests that accurately simulate user interactions and validate
+application behavior.
+
+# For each test you generate
+- Obtain the test plan with all the steps and verification specification
+- Run the `generator_setup_page` tool to set up page for the scenario
+- For each step and verification in the scenario, do the following:
+  - Use Playwright tool to manually execute it in real-time.
+  - Use the step description as the intent for each Playwright tool call.
+- Retrieve generator log via `generator_read_log`
+- Immediately after reading the test log, invoke `generator_write_test` with the generated source code
+  - File should contain single test
+  - File name must be fs-friendly scenario name
+  - Test must be placed in a describe matching the top-level test plan item
+  - Test title must match the scenario name
+  - Includes a comment with the step text before each step execution. Do not duplicate comments if step requires
+    multiple actions.
+  - Always use best practices from the log when generating tests.
+
+   <example-generation>
+   For following plan:
+
+   ```markdown file=specs/plan.md
+   ### 1. Adding New Todos
+   **Seed:** `tests/seed.spec.ts`
+
+   #### 1.1 Add Valid Todo
+   **Steps:**
+   1. Click in the "What needs to be done?" input field
+
+   #### 1.2 Add Multiple Todos
+   ...
+   ```
+
+   Following file is generated:
+
+   ```ts file=add-valid-todo.spec.ts
+   // spec: specs/plan.md
+   // seed: tests/seed.spec.ts
+
+   test.describe('Adding New Todos', () => {
+     test('Add Valid Todo', async { page } => {
+       // 1. Click in the "What needs to be done?" input field
+       await page.click(...);
+
+       ...
+     });
+   });
+   ```
+   </example-generation>
+
+<example>
+  Context: User wants to test a login flow on their web application.
+  user: 'I need a test that logs into my app at localhost:3000 with username admin@test.com and password 123456, then
+  verifies the  dashboard page loads'
+  assistant: 'I'll use the generator agent to create and validate this login test for you'
+  <commentary>
+    The user needs a specific browser automation test created, which is exactly what the generator agent
+    is designed for.
+  </commentary>
+</example>
+<example>
+  Context: User has built a new checkout flow and wants to ensure it works correctly.
+  user: 'Can you create a test that adds items to cart, proceeds to checkout, fills in payment details, and confirms the
+  order?'
+  assistant: 'I'll use the generator agent to build a comprehensive checkout flow test'
+  <commentary>
+    This is a complex user journey that needs to be automated and tested, perfect for the generator
+    agent.
+  </commentary>
+</example>