@metamask/snaps-utils 8.0.1 → 8.1.1

package/dist/chunk-6ATNGN44.js

@@ -1,300 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/ui.tsx
-var _snapssdk = require('@metamask/snaps-sdk');
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-var _jsx = require('@metamask/snaps-sdk/jsx');
-
-
-
-
-
-
-var _utils = require('@metamask/utils');
-var _marked = require('marked');
-var _jsxruntime = require('@metamask/snaps-sdk/jsx-runtime');
-var MAX_TEXT_LENGTH = 5e4;
-var ALLOWED_PROTOCOLS = ["https:", "mailto:"];
-function getButtonVariant(variant) {
-  switch (variant) {
-    case "primary":
-      return "primary";
-    case "secondary":
-      return "destructive";
-    default:
-      return void 0;
-  }
-}
-function getChildren(elements) {
-  if (elements.length === 1) {
-    return elements[0];
-  }
-  return elements;
-}
-function getLinkText(token) {
-  if (token.tokens && token.tokens.length > 0) {
-    return getChildren(token.tokens.flatMap(getTextChildFromToken));
-  }
-  return token.href;
-}
-function getTextChildFromTokens(tokens) {
-  return getChildren(tokens.flatMap(getTextChildFromToken));
-}
-function getTextChildFromToken(token) {
-  switch (token.type) {
-    case "link": {
-      return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Link, { href: token.href, children: getLinkText(token) });
-    }
-    case "text":
-      return token.text;
-    case "strong":
-      return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Bold, { children: getTextChildFromTokens(
-        // Due to the way `marked` is typed, `token.tokens` can be
-        // `undefined`, but it's a required field of `Tokens.Bold`, so we
-        // can safely cast it to `Token[]`.
-        token.tokens
-      ) });
-    case "em":
-      return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Italic, { children: getTextChildFromTokens(
-        // Due to the way `marked` is typed, `token.tokens` can be
-        // `undefined`, but it's a required field of `Tokens.Bold`, so we
-        // can safely cast it to `Token[]`.
-        token.tokens
-      ) });
-    default:
-      return null;
-  }
-}
-function getTextChildren(value) {
-  const rootTokens = _marked.lexer.call(void 0, value, { gfm: false });
-  const children = [];
-  _marked.walkTokens.call(void 0, rootTokens, (token) => {
-    if (token.type === "paragraph") {
-      if (children.length > 0) {
-        children.push("\n\n");
-      }
-      const { tokens } = token;
-      children.push(
-        ...tokens.flatMap(getTextChildFromToken)
-      );
-    }
-  });
-  return children.filter((child) => child !== null);
-}
-function validateComponentTextSize(component) {
-  const textSize = getTotalTextLength(component);
-  _utils.assert.call(void 0, 
-    textSize <= MAX_TEXT_LENGTH,
-    `The text in a Snap UI may not be larger than ${MAX_TEXT_LENGTH / 1e3} kB.`
-  );
-}
-function getJsxElementFromComponent(legacyComponent) {
-  validateComponentTextSize(legacyComponent);
-  function getElement(component) {
-    switch (component.type) {
-      case _snapssdk.NodeType.Address:
-        return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Address, { address: component.value });
-      case _snapssdk.NodeType.Button:
-        return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          _jsx.Button,
-          {
-            name: component.name,
-            variant: getButtonVariant(component.variant),
-            type: component.buttonType,
-            children: component.value
-          }
-        );
-      case _snapssdk.NodeType.Copyable:
-        return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Copyable, { value: component.value, sensitive: component.sensitive });
-      case _snapssdk.NodeType.Divider:
-        return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Divider, {});
-      case _snapssdk.NodeType.Form:
-        return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Form, { name: component.name, children: getChildren(component.children.map(getElement)) });
-      case _snapssdk.NodeType.Heading:
-        return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Heading, { children: component.value });
-      case _snapssdk.NodeType.Image:
-        return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Image, { src: component.value });
-      case _snapssdk.NodeType.Input:
-        return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Field, { label: component.label, error: component.error, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          _jsx.Input,
-          {
-            name: component.name,
-            type: component.inputType,
-            value: component.value,
-            placeholder: component.placeholder
-          }
-        ) });
-      case _snapssdk.NodeType.Panel:
-        return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Box, { children: getChildren(component.children.map(getElement)) });
-      case _snapssdk.NodeType.Row:
-        return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Row, { label: component.label, variant: component.variant, children: getElement(component.value) });
-      case _snapssdk.NodeType.Spinner:
-        return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Spinner, {});
-      case _snapssdk.NodeType.Text:
-        return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsx.Text, { children: getChildren(getTextChildren(component.value)) });
-      default:
-        return _utils.assertExhaustive.call(void 0, component);
-    }
-  }
-  return getElement(legacyComponent);
-}
-function getMarkdownLinks(text) {
-  const tokens = _marked.lexer.call(void 0, text, { gfm: false });
-  const links = [];
-  _marked.walkTokens.call(void 0, tokens, (token) => {
-    if (token.type === "link") {
-      links.push(token);
-    }
-  });
-  return links;
-}
-function validateLink(link, isOnPhishingList) {
-  try {
-    const url = new URL(link);
-    _utils.assert.call(void 0, 
-      ALLOWED_PROTOCOLS.includes(url.protocol),
-      `Protocol must be one of: ${ALLOWED_PROTOCOLS.join(", ")}.`
-    );
-    const hostname = url.protocol === "mailto:" ? url.pathname.split("@")[1] : url.hostname;
-    _utils.assert.call(void 0, !isOnPhishingList(hostname), "The specified URL is not allowed.");
-  } catch (error) {
-    throw new Error(
-      `Invalid URL: ${error instanceof _utils.AssertionError ? error.message : "Unable to parse URL."}`
-    );
-  }
-}
-function validateTextLinks(text, isOnPhishingList) {
-  const links = getMarkdownLinks(text);
-  for (const link of links) {
-    validateLink(link.href, isOnPhishingList);
-  }
-}
-function validateJsxLinks(node, isOnPhishingList) {
-  walkJsx(node, (childNode) => {
-    if (childNode.type !== "Link") {
-      return;
-    }
-    validateLink(childNode.props.href, isOnPhishingList);
-  });
-}
-function getTotalTextLength(component) {
-  const { type } = component;
-  switch (type) {
-    case _snapssdk.NodeType.Panel:
-      return component.children.reduce(
-        // This is a bug in TypeScript: https://github.com/microsoft/TypeScript/issues/48313
-        // eslint-disable-next-line @typescript-eslint/restrict-plus-operands
-        (sum, node) => sum + getTotalTextLength(node),
-        0
-      );
-    case _snapssdk.NodeType.Row:
-      return getTotalTextLength(component.value);
-    case _snapssdk.NodeType.Text:
-      return component.value.length;
-    default:
-      return 0;
-  }
-}
-function hasChildren(element) {
-  return _utils.hasProperty.call(void 0, element.props, "children");
-}
-function filterJsxChild(child) {
-  return Boolean(child) && child !== true;
-}
-function getJsxChildren(element) {
-  if (hasChildren(element)) {
-    if (Array.isArray(element.props.children)) {
-      return element.props.children.filter(filterJsxChild).flat(Infinity);
-    }
-    if (element.props.children) {
-      return [element.props.children];
-    }
-  }
-  return [];
-}
-function walkJsx(node, callback, depth = 0) {
-  if (Array.isArray(node)) {
-    for (const child of node) {
-      const childResult = walkJsx(child, callback, depth);
-      if (childResult !== void 0) {
-        return childResult;
-      }
-    }
-    return void 0;
-  }
-  const result = callback(node, depth);
-  if (result !== void 0) {
-    return result;
-  }
-  if (_utils.hasProperty.call(void 0, node, "props") && _utils.isPlainObject.call(void 0, node.props) && _utils.hasProperty.call(void 0, node.props, "children")) {
-    const children = getJsxChildren(node);
-    for (const child of children) {
-      if (_utils.isPlainObject.call(void 0, child)) {
-        const childResult = walkJsx(child, callback, depth + 1);
-        if (childResult !== void 0) {
-          return childResult;
-        }
-      }
-    }
-  }
-  return void 0;
-}
-function serialiseProp(prop) {
-  if (typeof prop === "string") {
-    return `"${prop}"`;
-  }
-  return `{${JSON.stringify(prop)}}`;
-}
-function serialiseProps(props) {
-  return Object.entries(props).filter(([key]) => key !== "children").sort(([a], [b]) => a.localeCompare(b)).map(([key, value]) => ` ${key}=${serialiseProp(value)}`).join("");
-}
-function serialiseJsx(node, indentation = 0) {
-  if (Array.isArray(node)) {
-    return node.map((child) => serialiseJsx(child, indentation)).join("");
-  }
-  const indent = "  ".repeat(indentation);
-  if (typeof node === "string") {
-    return `${indent}${node}
-`;
-  }
-  if (!node) {
-    return "";
-  }
-  const { type, props } = node;
-  const trailingNewline = indentation > 0 ? "\n" : "";
-  if (_utils.hasProperty.call(void 0, props, "children")) {
-    const children = serialiseJsx(props.children, indentation + 1);
-    return `${indent}<${type}${serialiseProps(
-      props
-    )}>
-${children}${indent}</${type}>${trailingNewline}`;
-  }
-  return `${indent}<${type}${serialiseProps(props)} />${trailingNewline}`;
-}
-
-
-
-
-
-
-
-
-
-
-
-exports.getTextChildren = getTextChildren; exports.getJsxElementFromComponent = getJsxElementFromComponent; exports.validateTextLinks = validateTextLinks; exports.validateJsxLinks = validateJsxLinks; exports.getTotalTextLength = getTotalTextLength; exports.hasChildren = hasChildren; exports.getJsxChildren = getJsxChildren; exports.walkJsx = walkJsx; exports.serialiseJsx = serialiseJsx;
-//# sourceMappingURL=chunk-6ATNGN44.js.map

package/dist/chunk-6ATNGN44.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ui.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { Component } from '@metamask/snaps-sdk';\nimport { NodeType } from '@metamask/snaps-sdk';\nimport type {\n  BoldChildren,\n  GenericSnapElement,\n  ItalicChildren,\n  JSXElement,\n  LinkElement,\n  Nestable,\n  RowChildren,\n  SnapNode,\n  StandardFormattingElement,\n  TextChildren,\n} from '@metamask/snaps-sdk/jsx';\nimport {\n  Italic,\n  Link,\n  Bold,\n  Row,\n  Text,\n  Field,\n  Image,\n  Input,\n  Heading,\n  Form,\n  Divider,\n  Spinner,\n  Copyable,\n  Box,\n  Button,\n  Address,\n} from '@metamask/snaps-sdk/jsx';\nimport {\n  assert,\n  assertExhaustive,\n  AssertionError,\n  hasProperty,\n  isPlainObject,\n} from '@metamask/utils';\nimport { lexer, walkTokens } from 'marked';\nimport type { Token, Tokens } from 'marked';\n\nconst MAX_TEXT_LENGTH = 50_000; // 50 kb\nconst ALLOWED_PROTOCOLS = ['https:', 'mailto:'];\n\n/**\n * Get the button variant from a legacy button component variant.\n *\n * @param variant - The legacy button component variant.\n * @returns The button variant.\n */\nfunction getButtonVariant(variant?: 'primary' | 'secondary' | undefined) {\n  switch (variant) {\n    case 'primary':\n      return 'primary';\n    case 'secondary':\n      return 'destructive';\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Get the children of a JSX element. If there is only one child, the child is\n * returned directly. Otherwise, the children are returned as an array.\n *\n * @param elements - The JSX elements.\n * @returns The child or children.\n */\nfunction getChildren<Type>(elements: Type[]) {\n  if (elements.length === 1) {\n    return elements[0];\n  }\n\n  return elements;\n}\n\n/**\n * Get the text of a link token.\n *\n * @param token - The link token.\n * @returns The text of the link token.\n */\nfunction getLinkText(token: Tokens.Link | Tokens.Generic) {\n  if (token.tokens && token.tokens.length > 0) {\n    return getChildren(token.tokens.flatMap(getTextChildFromToken));\n  }\n\n  return token.href;\n}\n\n/**\n * Get the text child from a list of markdown tokens.\n *\n * @param tokens - The markdown tokens.\n * @returns The text child.\n */\nfunction getTextChildFromTokens(tokens: Token[]) {\n  return getChildren(tokens.flatMap(getTextChildFromToken));\n}\n\n/**\n * Get the text child from a markdown token.\n *\n * @param token - The markdown token.\n * @returns The text child.\n */\nfunction getTextChildFromToken(token: Token): TextChildren {\n  switch (token.type) {\n    case 'link': {\n      return <Link href={token.href} children={getLinkText(token)} />;\n    }\n\n    case 'text':\n      return token.text;\n\n    case 'strong':\n      return (\n        <Bold>\n          {\n            getTextChildFromTokens(\n              // Due to the way `marked` is typed, `token.tokens` can be\n              // `undefined`, but it's a required field of `Tokens.Bold`, so we\n              // can safely cast it to `Token[]`.\n              token.tokens as Token[],\n            ) as BoldChildren\n          }\n        </Bold>\n      );\n\n    case 'em':\n      return (\n        <Italic>\n          {\n            getTextChildFromTokens(\n              // Due to the way `marked` is typed, `token.tokens` can be\n              // `undefined`, but it's a required field of `Tokens.Bold`, so we\n              // can safely cast it to `Token[]`.\n              token.tokens as Token[],\n            ) as ItalicChildren\n          }\n        </Italic>\n      );\n\n    default:\n      return null;\n  }\n}\n\n/**\n * Get all text children from a markdown string.\n *\n * @param value - The markdown string.\n * @returns The text children.\n */\nexport function getTextChildren(\n  value: string,\n): (string | StandardFormattingElement | LinkElement)[] {\n  const rootTokens = lexer(value, { gfm: false });\n  const children: (string | StandardFormattingElement | LinkElement | null)[] =\n    [];\n\n  walkTokens(rootTokens, (token) => {\n    if (token.type === 'paragraph') {\n      if (children.length > 0) {\n        children.push('\\n\\n');\n      }\n\n      const { tokens } = token as Tokens.Paragraph;\n      // We do not need to consider nesting deeper than 1 level here and we can therefore cast.\n      children.push(\n        ...(tokens.flatMap(getTextChildFromToken) as (\n          | string\n          | StandardFormattingElement\n          | LinkElement\n          | null\n        )[]),\n      );\n    }\n  });\n\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion\n  return children.filter((child) => child !== null) as (\n    | string\n    | StandardFormattingElement\n    | LinkElement\n  )[];\n}\n\n/**\n * Validate the text size of a component. The text size is the total length of\n * all text in the component.\n *\n * @param component - The component to validate.\n * @throws An error if the text size exceeds the maximum allowed size.\n */\nfunction validateComponentTextSize(component: Component) {\n  const textSize = getTotalTextLength(component);\n  assert(\n    textSize <= MAX_TEXT_LENGTH,\n    `The text in a Snap UI may not be larger than ${\n      MAX_TEXT_LENGTH / 1000\n    } kB.`,\n  );\n}\n\n/**\n * Get a JSX element from a legacy UI component. This supports all legacy UI\n * components, and maps them to their JSX equivalents where possible.\n *\n * This function validates the text size of the component, but does not validate\n * the total size. The total size of the component should be validated before\n * calling this function.\n *\n * @param legacyComponent - The legacy UI component.\n * @returns The JSX element.\n */\nexport function getJsxElementFromComponent(\n  legacyComponent: Component,\n): JSXElement {\n  validateComponentTextSize(legacyComponent);\n\n  /**\n   * Get the JSX element for a component. This function is recursive and will\n   * call itself for child components.\n   *\n   * @param component - The component to convert to a JSX element.\n   * @returns The JSX element.\n   */\n  function getElement(component: Component) {\n    switch (component.type) {\n      case NodeType.Address:\n        return <Address address={component.value} />;\n\n      case NodeType.Button:\n        return (\n          <Button\n            name={component.name}\n            variant={getButtonVariant(component.variant)}\n            type={component.buttonType}\n          >\n            {component.value}\n          </Button>\n        );\n\n      case NodeType.Copyable:\n        return (\n          <Copyable value={component.value} sensitive={component.sensitive} />\n        );\n\n      case NodeType.Divider:\n        return <Divider />;\n\n      case NodeType.Form:\n        return (\n          <Form name={component.name}>\n            {getChildren(component.children.map(getElement))}\n          </Form>\n        );\n\n      case NodeType.Heading:\n        return <Heading children={component.value} />;\n\n      case NodeType.Image:\n        // `Image` supports `alt`, but the legacy `Image` component does not.\n        return <Image src={component.value} />;\n\n      case NodeType.Input:\n        return (\n          <Field label={component.label} error={component.error}>\n            <Input\n              name={component.name}\n              type={component.inputType}\n              value={component.value}\n              placeholder={component.placeholder}\n            />\n          </Field>\n        );\n\n      case NodeType.Panel:\n        // `Panel` is renamed to `Box` in JSX.\n        return (\n          <Box children={getChildren(component.children.map(getElement))} />\n        );\n\n      case NodeType.Row:\n        return (\n          <Row label={component.label} variant={component.variant}>\n            {getElement(component.value) as RowChildren}\n          </Row>\n        );\n\n      case NodeType.Spinner:\n        return <Spinner />;\n\n      case NodeType.Text:\n        return <Text>{getChildren(getTextChildren(component.value))}</Text>;\n\n      /* istanbul ignore next 2 */\n      default:\n        return assertExhaustive(component);\n    }\n  }\n\n  return getElement(legacyComponent);\n}\n\n/**\n * Extract all links from a Markdown text string using the `marked` lexer.\n *\n * @param text - The markdown text string.\n * @returns A list of URLs linked to in the string.\n */\nfunction getMarkdownLinks(text: string) {\n  const tokens = lexer(text, { gfm: false });\n  const links: Tokens.Link[] = [];\n\n  // Walk the lexed tokens and collect all link tokens\n  walkTokens(tokens, (token) => {\n    if (token.type === 'link') {\n      links.push(token as Tokens.Link);\n    }\n  });\n\n  return links;\n}\n\n/**\n * Validate a link against the phishing list.\n *\n * @param link - The link to validate.\n * @param isOnPhishingList - The function that checks the link against the\n * phishing list.\n */\nfunction validateLink(\n  link: string,\n  isOnPhishingList: (url: string) => boolean,\n) {\n  try {\n    const url = new URL(link);\n    assert(\n      ALLOWED_PROTOCOLS.includes(url.protocol),\n      `Protocol must be one of: ${ALLOWED_PROTOCOLS.join(', ')}.`,\n    );\n\n    const hostname =\n      url.protocol === 'mailto:' ? url.pathname.split('@')[1] : url.hostname;\n\n    assert(!isOnPhishingList(hostname), 'The specified URL is not allowed.');\n  } catch (error) {\n    throw new Error(\n      `Invalid URL: ${\n        error instanceof AssertionError ? error.message : 'Unable to parse URL.'\n      }`,\n    );\n  }\n}\n\n/**\n * Search for Markdown links in a string and checks them against the phishing\n * list.\n *\n * @param text - The text to verify.\n * @param isOnPhishingList - The function that checks the link against the\n * phishing list.\n * @throws If the text contains a link that is not allowed.\n */\nexport function validateTextLinks(\n  text: string,\n  isOnPhishingList: (url: string) => boolean,\n) {\n  const links = getMarkdownLinks(text);\n\n  for (const link of links) {\n    validateLink(link.href, isOnPhishingList);\n  }\n}\n\n/**\n * Walk a JSX tree and validate each {@link LinkElement} node against the\n * phishing list.\n *\n * @param node - The JSX node to walk.\n * @param isOnPhishingList - The function that checks the link against the\n * phishing list.\n */\nexport function validateJsxLinks(\n  node: JSXElement,\n  isOnPhishingList: (url: string) => boolean,\n) {\n  walkJsx(node, (childNode) => {\n    if (childNode.type !== 'Link') {\n      return;\n    }\n\n    validateLink(childNode.props.href, isOnPhishingList);\n  });\n}\n\n/**\n * Calculate the total length of all text in the component.\n *\n * @param component - A custom UI component.\n * @returns The total length of all text components in the component.\n */\nexport function getTotalTextLength(component: Component): number {\n  const { type } = component;\n\n  switch (type) {\n    case NodeType.Panel:\n      return component.children.reduce<number>(\n        // This is a bug in TypeScript: https://github.com/microsoft/TypeScript/issues/48313\n        // eslint-disable-next-line @typescript-eslint/restrict-plus-operands\n        (sum, node) => sum + getTotalTextLength(node),\n        0,\n      );\n\n    case NodeType.Row:\n      return getTotalTextLength(component.value);\n\n    case NodeType.Text:\n      return component.value.length;\n\n    default:\n      return 0;\n  }\n}\n\n/**\n * Check if a JSX element has children.\n *\n * @param element - A JSX element.\n * @returns `true` if the element has children, `false` otherwise.\n */\nexport function hasChildren<Element extends JSXElement>(\n  element: Element,\n): element is Element & {\n  props: { children: Nestable<JSXElement | string> };\n} {\n  return hasProperty(element.props, 'children');\n}\n\n/**\n * Filter a JSX child to remove `null`, `undefined`, plain booleans, and empty\n * strings.\n *\n * @param child - The JSX child to filter.\n * @returns `true` if the child is not `null`, `undefined`, a plain boolean, or\n * an empty string, `false` otherwise.\n */\nfunction filterJsxChild(child: JSXElement | string | boolean | null): boolean {\n  return Boolean(child) && child !== true;\n}\n\n/**\n * Get the children of a JSX element as an array. If the element has only one\n * child, the child is returned as an array.\n *\n * @param element - A JSX element.\n * @returns The children of the element.\n */\nexport function getJsxChildren(element: JSXElement): (JSXElement | string)[] {\n  if (hasChildren(element)) {\n    if (Array.isArray(element.props.children)) {\n      // @ts-expect-error - Each member of the union type has signatures, but\n      // none of those signatures are compatible with each other.\n      return element.props.children.filter(filterJsxChild).flat(Infinity);\n    }\n\n    if (element.props.children) {\n      return [element.props.children];\n    }\n  }\n\n  return [];\n}\n\n/**\n * Walk a JSX tree and call a callback on each node.\n *\n * @param node - The JSX node to walk.\n * @param callback - The callback to call on each node.\n * @param depth - The current depth in the JSX tree for a walk.\n * @returns The result of the callback, if any.\n */\nexport function walkJsx<Value>(\n  node: JSXElement | JSXElement[],\n  callback: (node: JSXElement, depth: number) => Value | undefined,\n  depth = 0,\n): Value | undefined {\n  if (Array.isArray(node)) {\n    for (const child of node) {\n      const childResult = walkJsx(child as JSXElement, callback, depth);\n      if (childResult !== undefined) {\n        return childResult;\n      }\n    }\n\n    return undefined;\n  }\n\n  const result = callback(node, depth);\n  if (result !== undefined) {\n    return result;\n  }\n\n  if (\n    hasProperty(node, 'props') &&\n    isPlainObject(node.props) &&\n    hasProperty(node.props, 'children')\n  ) {\n    const children = getJsxChildren(node);\n    for (const child of children) {\n      if (isPlainObject(child)) {\n        const childResult = walkJsx(child, callback, depth + 1);\n        if (childResult !== undefined) {\n          return childResult;\n        }\n      }\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Serialise a JSX prop to a string.\n *\n * @param prop - The JSX prop.\n * @returns The serialised JSX prop.\n */\nfunction serialiseProp(prop: unknown): string {\n  if (typeof prop === 'string') {\n    return `\"${prop}\"`;\n  }\n\n  return `{${JSON.stringify(prop)}}`;\n}\n\n/**\n * Serialise JSX props to a string.\n *\n * @param props - The JSX props.\n * @returns The serialised JSX props.\n */\nfunction serialiseProps(props: Record<string, unknown>): string {\n  return Object.entries(props)\n    .filter(([key]) => key !== 'children')\n    .sort(([a], [b]) => a.localeCompare(b))\n    .map(([key, value]) => ` ${key}=${serialiseProp(value)}`)\n    .join('');\n}\n\n/**\n * Serialise a JSX node to a string.\n *\n * @param node - The JSX node.\n * @param indentation - The indentation level. Defaults to `0`. This should not\n * be set by the caller, as it is used for recursion.\n * @returns The serialised JSX node.\n */\nexport function serialiseJsx(node: SnapNode, indentation = 0): string {\n  if (Array.isArray(node)) {\n    return node.map((child) => serialiseJsx(child, indentation)).join('');\n  }\n\n  const indent = '  '.repeat(indentation);\n  if (typeof node === 'string') {\n    return `${indent}${node}\\n`;\n  }\n\n  if (!node) {\n    return '';\n  }\n\n  const { type, props } = node as GenericSnapElement;\n  const trailingNewline = indentation > 0 ? '\\n' : '';\n\n  if (hasProperty(props, 'children')) {\n    const children = serialiseJsx(props.children as SnapNode, indentation + 1);\n    return `${indent}<${type}${serialiseProps(\n      props,\n    )}>\\n${children}${indent}</${type}>${trailingNewline}`;\n  }\n\n  return `${indent}<${type}${serialiseProps(props)} />${trailingNewline}`;\n}\n"]}

package/dist/chunk-6HXIPMBN.js

@@ -1,103 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-var _chunkMKFQAXRFjs = require('./chunk-MKFQAXRF.js');
-
-
-var _chunk7VJ2BOVUjs = require('./chunk-7VJ2BOVU.js');
-
-// src/fs.ts
-var _fs = require('fs');
-var _os = require('os'); var _os2 = _interopRequireDefault(_os);
-var _path = require('path'); var _path2 = _interopRequireDefault(_path);
-async function isDirectory(pathString, createDir) {
-  try {
-    const stats = await _fs.promises.stat(pathString);
-    return stats.isDirectory();
-  } catch (error) {
-    if (error.code === "ENOENT") {
-      if (!createDir) {
-        return false;
-      }
-      await _fs.promises.mkdir(pathString, { recursive: true });
-      return true;
-    }
-    return false;
-  }
-}
-async function isFile(pathString) {
-  try {
-    const stats = await _fs.promises.stat(pathString);
-    return stats.isFile();
-  } catch (error) {
-    return false;
-  }
-}
-async function readJsonFile(pathString) {
-  if (!pathString.endsWith(".json")) {
-    throw new Error('The specified file must be a ".json" file.');
-  }
-  let file;
-  try {
-    file = await _chunkMKFQAXRFjs.readVirtualFile.call(void 0, pathString, "utf8");
-  } catch (error) {
-    if (error.code === "ENOENT") {
-      throw new Error(
-        `Could not find '${pathString}'. Please ensure that the file exists.`
-      );
-    }
-    throw error;
-  }
-  file.result = _chunk7VJ2BOVUjs.parseJson.call(void 0, file.toString());
-  return file;
-}
-function getOutfilePath(outDir, outFileName) {
-  return _path2.default.join(outDir, outFileName || "bundle.js");
-}
-function validateOutfileName(filename) {
-  if (!filename.endsWith(".js") || filename === ".js" || _path2.default.basename(filename) !== filename) {
-    throw new Error(`Invalid outfile name: ${filename}. Must be a .js file`);
-  }
-  return true;
-}
-async function validateFilePath(filePath) {
-  const exists = await isFile(filePath);
-  if (!exists) {
-    throw new Error(
-      `Invalid params: '${filePath}' is not a file or does not exist.`
-    );
-  }
-  return true;
-}
-async function validateDirPath(dirPath, createDir) {
-  const exists = await isDirectory(dirPath, createDir);
-  if (!exists) {
-    throw new Error(
-      `Invalid params: '${dirPath}' is not a directory or could not be created.`
-    );
-  }
-  return true;
-}
-async function useTemporaryFile(fileName, fileContents, fn) {
-  const filePath = _path2.default.join(_os2.default.tmpdir(), fileName);
-  await _fs.promises.mkdir(_path2.default.dirname(filePath), { recursive: true });
-  await _fs.promises.writeFile(filePath, fileContents);
-  try {
-    await fn(filePath);
-  } finally {
-    if (await isFile(filePath)) {
-      await _fs.promises.unlink(filePath);
-    }
-  }
-}
-
-
-
-
-
-
-
-
-
-
-exports.isDirectory = isDirectory; exports.isFile = isFile; exports.readJsonFile = readJsonFile; exports.getOutfilePath = getOutfilePath; exports.validateOutfileName = validateOutfileName; exports.validateFilePath = validateFilePath; exports.validateDirPath = validateDirPath; exports.useTemporaryFile = useTemporaryFile;
-//# sourceMappingURL=chunk-6HXIPMBN.js.map

package/dist/chunk-6HXIPMBN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/fs.ts"],"names":[],"mappings":";;;;;;;;AACA,SAAS,YAAY,UAAU;AAC/B,OAAO,QAAQ;AACf,OAAO,eAAe;AActB,eAAsB,YACpB,YACA,WACkB;AAClB,MAAI;AACF,UAAM,QAAQ,MAAM,GAAG,KAAK,UAAU;AACtC,WAAO,MAAM,YAAY;AAAA,EAC3B,SAAS,OAAO;AACd,QAAI,MAAM,SAAS,UAAU;AAC3B,UAAI,CAAC,WAAW;AACd,eAAO;AAAA,MACT;AAEA,YAAM,GAAG,MAAM,YAAY,EAAE,WAAW,KAAK,CAAC;AAC9C,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AACF;AAQA,eAAsB,OAAO,YAAsC;AACjE,MAAI;AACF,UAAM,QAAQ,MAAM,GAAG,KAAK,UAAU;AACtC,WAAO,MAAM,OAAO;AAAA,EACtB,SAAS,OAAO;AACd,WAAO;AAAA,EACT;AACF;AAQA,eAAsB,aACpB,YAC4B;AAC5B,MAAI,CAAC,WAAW,SAAS,OAAO,GAAG;AACjC,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AAEA,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,gBAAgB,YAAY,MAAM;AAAA,EACjD,SAAS,OAAO;AACd,QAAI,MAAM,SAAS,UAAU;AAC3B,YAAM,IAAI;AAAA,QACR,mBAAmB,UAAU;AAAA,MAC/B;AAAA,IACF;AAEA,UAAM;AAAA,EACR;AACA,OAAK,SAAS,UAAU,KAAK,SAAS,CAAC;AACvC,SAAO;AACT;AAUO,SAAS,eAAe,QAAgB,aAA6B;AAC1E,SAAO,UAAU,KAAK,QAAQ,eAAe,WAAW;AAC1D;AAUO,SAAS,oBAAoB,UAA2B;AAC7D,MACE,CAAC,SAAS,SAAS,KAAK,KACxB,aAAa,SACb,UAAU,SAAS,QAAQ,MAAM,UACjC;AACA,UAAM,IAAI,MAAM,yBAAyB,QAAQ,sBAAsB;AAAA,EACzE;AACA,SAAO;AACT;AASA,eAAsB,iBAAiB,UAAoC;AACzE,QAAM,SAAS,MAAM,OAAO,QAAQ;AACpC,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR,oBAAoB,QAAQ;AAAA,IAC9B;AAAA,EACF;AACA,SAAO;AACT;AAUA,eAAsB,gBACpB,SACA,WACkB;AAClB,QAAM,SAAS,MAAM,YAAY,SAAS,SAAS;AACnD,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR,oBAAoB,OAAO;AAAA,IAC7B;AAAA,EACF;AACA,SAAO;AACT;AAUA,eAAsB,iBACpB,UACA,cACA,IACe;AACf,QAAM,WAAW,UAAU,KAAK,GAAG,OAAO,GAAG,QAAQ;AACrD,QAAM,GAAG,MAAM,UAAU,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAC/D,QAAM,GAAG,UAAU,UAAU,YAAY;AACzC,MAAI;AACF,UAAM,GAAG,QAAQ;AAAA,EACnB,UAAE;AACA,QAAI,MAAM,OAAO,QAAQ,GAAG;AAC1B,YAAM,GAAG,OAAO,QAAQ;AAAA,IAC1B;AAAA,EACF;AACF","sourcesContent":["import type { Json } from '@metamask/utils';\nimport { promises as fs } from 'fs';\nimport os from 'os';\nimport pathUtils from 'path';\n\nimport { parseJson } from './json';\nimport type { VirtualFile } from './virtual-file';\nimport { readVirtualFile } from './virtual-file/node';\n\n/**\n * Checks whether the given path string resolves to an existing directory, and\n * optionally creates the directory if it doesn't exist.\n *\n * @param pathString - The path string to check.\n * @param createDir - Whether to create the directory if it doesn't exist.\n * @returns Whether the given path is an existing directory.\n */\nexport async function isDirectory(\n  pathString: string,\n  createDir: boolean,\n): Promise<boolean> {\n  try {\n    const stats = await fs.stat(pathString);\n    return stats.isDirectory();\n  } catch (error) {\n    if (error.code === 'ENOENT') {\n      if (!createDir) {\n        return false;\n      }\n\n      await fs.mkdir(pathString, { recursive: true });\n      return true;\n    }\n\n    return false;\n  }\n}\n\n/**\n * Checks whether the given path string resolves to an existing file.\n *\n * @param pathString - The path string to check.\n * @returns Whether the given path is an existing file.\n */\nexport async function isFile(pathString: string): Promise<boolean> {\n  try {\n    const stats = await fs.stat(pathString);\n    return stats.isFile();\n  } catch (error) {\n    return false;\n  }\n}\n\n/**\n * Reads a `.json` file, parses its contents, and returns them.\n *\n * @param pathString - The path to the JSON file.\n * @returns The parsed contents of the JSON file.\n */\nexport async function readJsonFile<Type extends Json = Json>(\n  pathString: string,\n): Promise<VirtualFile<Type>> {\n  if (!pathString.endsWith('.json')) {\n    throw new Error('The specified file must be a \".json\" file.');\n  }\n\n  let file;\n  try {\n    file = await readVirtualFile(pathString, 'utf8');\n  } catch (error) {\n    if (error.code === 'ENOENT') {\n      throw new Error(\n        `Could not find '${pathString}'. Please ensure that the file exists.`,\n      );\n    }\n\n    throw error;\n  }\n  file.result = parseJson(file.toString());\n  return file as VirtualFile<Type>;\n}\n\n/**\n * Gets the complete out file path from an output file name and parent\n * directory path.\n *\n * @param outDir - The path to the out file's parent directory.\n * @param outFileName - The out file's name.\n * @returns The complete path to the out file.\n */\nexport function getOutfilePath(outDir: string, outFileName: string): string {\n  return pathUtils.join(outDir, outFileName || 'bundle.js');\n}\n\n/**\n * Ensures that the outfile name is just a `.js` file name.\n * Throws on validation failure.\n *\n * @param filename - The file name to validate.\n * @returns `true` if validation succeeded.\n * @throws If the file name is invalid.\n */\nexport function validateOutfileName(filename: string): boolean {\n  if (\n    !filename.endsWith('.js') ||\n    filename === '.js' ||\n    pathUtils.basename(filename) !== filename\n  ) {\n    throw new Error(`Invalid outfile name: ${filename}. Must be a .js file`);\n  }\n  return true;\n}\n\n/**\n * Validates a file path. Throws on validation failure.\n *\n * @param filePath - The file path to validate.\n * @returns `true` if validation succeeded.\n * @throws If the path does not resolve to a file.\n */\nexport async function validateFilePath(filePath: string): Promise<boolean> {\n  const exists = await isFile(filePath);\n  if (!exists) {\n    throw new Error(\n      `Invalid params: '${filePath}' is not a file or does not exist.`,\n    );\n  }\n  return true;\n}\n\n/**\n * Validates a directory path. Throws on validation failure.\n *\n * @param dirPath - The directory path to validate.\n * @param createDir - Whether to create the directory if it doesn't exist.\n * @returns `true` if validation succeeded or the directory was created.\n * @throws If the directory does not exist or could not be created.\n */\nexport async function validateDirPath(\n  dirPath: string,\n  createDir: boolean,\n): Promise<boolean> {\n  const exists = await isDirectory(dirPath, createDir);\n  if (!exists) {\n    throw new Error(\n      `Invalid params: '${dirPath}' is not a directory or could not be created.`,\n    );\n  }\n  return true;\n}\n\n/**\n * Creates a temporary file with a given name and content, writes it to disk and calls the provided function.\n * This function handles deletion of the temporary file after usage.\n *\n * @param fileName - The name of the temporary file.\n * @param fileContents - The content of the temporary file.\n * @param fn - The callback function to call when the temporary file has been created.\n */\nexport async function useTemporaryFile(\n  fileName: string,\n  fileContents: string,\n  fn: (path: string) => Promise<unknown>,\n): Promise<void> {\n  const filePath = pathUtils.join(os.tmpdir(), fileName);\n  await fs.mkdir(pathUtils.dirname(filePath), { recursive: true });\n  await fs.writeFile(filePath, fileContents);\n  try {\n    await fn(filePath);\n  } finally {\n    if (await isFile(filePath)) {\n      await fs.unlink(filePath);\n    }\n  }\n}\n"]}

package/dist/chunk-6YJWU77L.js

@@ -1,19 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/manifest/validators/package-json-recommended-fields.ts
-var RECOMMENDED_FIELDS = ["repository"];
-var packageJsonRecommendedFields = {
-  severity: "warning",
-  semanticCheck(files, context) {
-    for (const recommendedField of RECOMMENDED_FIELDS) {
-      if (!files.packageJson.result[recommendedField]) {
-        context.report(
-          `Missing recommended package.json property: "${recommendedField}".`
-        );
-      }
-    }
-  }
-};
-
-
-
-exports.packageJsonRecommendedFields = packageJsonRecommendedFields;
-//# sourceMappingURL=chunk-6YJWU77L.js.map

package/dist/chunk-6YJWU77L.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/manifest/validators/package-json-recommended-fields.ts"],"names":[],"mappings":";AAEA,IAAM,qBAAqB,CAAC,YAAY;AAKjC,IAAM,+BAA8C;AAAA,EACzD,UAAU;AAAA,EACV,cAAc,OAAO,SAAS;AAC5B,eAAW,oBAAoB,oBAAoB;AACjD,UAAI,CAAC,MAAM,YAAY,OAAO,gBAAgB,GAAG;AAC/C,gBAAQ;AAAA,UACN,+CAA+C,gBAAgB;AAAA,QACjE;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF","sourcesContent":["import type { ValidatorMeta } from '../validator-types';\n\nconst RECOMMENDED_FIELDS = ['repository'] as const;\n\n/**\n * Check if package.json contains recommended fields.\n */\nexport const packageJsonRecommendedFields: ValidatorMeta = {\n  severity: 'warning',\n  semanticCheck(files, context) {\n    for (const recommendedField of RECOMMENDED_FIELDS) {\n      if (!files.packageJson.result[recommendedField]) {\n        context.report(\n          `Missing recommended package.json property: \"${recommendedField}\".`,\n        );\n      }\n    }\n  },\n};\n"]}