@metamask/snaps-sdk 6.2.1 → 6.4.0

package/dist/jsx/validation.mjs

@@ -0,0 +1,571 @@
+import { is, boolean, optional, array, lazy, nullable, number, object, record, string, tuple, refine } from "@metamask/superstruct";
+import { CaipAccountIdStruct, hasProperty, HexChecksumAddressStruct, isPlainObject, JsonStruct } from "@metamask/utils";
+import { literal, nullUnion, selectiveUnion, svg, typedUnion } from "../internals/index.mjs";
+import { IconName } from "./components/index.mjs";
+/**
+ * A struct for the {@link Key} type.
+ */
+export const KeyStruct = nullUnion([string(), number()]);
+/**
+ * A struct for the {@link StringElement} type.
+ */
+export const StringElementStruct = children([
+    string(),
+]);
+/**
+ * A struct for the {@link GenericSnapElement} type.
+ */
+export const ElementStruct = object({
+    type: string(),
+    props: record(string(), JsonStruct),
+    key: nullable(KeyStruct),
+});
+/**
+ * A helper function for creating a struct for a {@link Nestable} type.
+ *
+ * @param struct - The struct for the type to test.
+ * @returns The struct for the nestable type.
+ */
+function nestable(struct) {
+    const nestableStruct = selectiveUnion((value) => {
+        if (Array.isArray(value)) {
+            return array(lazy(() => nestableStruct));
+        }
+        return struct;
+    });
+    return nestableStruct;
+}
+/**
+ * A helper function for creating a struct which allows children of a specific
+ * type, as well as `null` and `boolean`.
+ *
+ * @param structs - The structs to allow as children.
+ * @returns The struct for the children.
+ */
+function children(structs) {
+    return nestable(nullable(selectiveUnion((value) => {
+        if (typeof value === 'boolean') {
+            return boolean();
+        }
+        if (structs.length === 1) {
+            return structs[0];
+        }
+        return nullUnion(structs);
+    })));
+}
+/**
+ * A helper function for creating a struct for a JSX element.
+ *
+ * @param name - The name of the element.
+ * @param props - The props of the element.
+ * @returns The struct for the element.
+ */
+function element(name, props = {}) {
+    return object({
+        type: literal(name),
+        props: object(props),
+        key: nullable(KeyStruct),
+    });
+}
+/**
+ * A struct for the {@link ImageElement} type.
+ */
+export const ImageStruct = element('Image', {
+    src: svg(),
+    alt: optional(string()),
+});
+const IconNameStruct = nullUnion(Object.values(IconName).map((name) => literal(name)));
+/**
+ * A struct for the {@link IconElement} type.
+ */
+export const IconStruct = element('Icon', {
+    name: IconNameStruct,
+    color: optional(nullUnion([literal('default'), literal('primary'), literal('muted')])),
+    size: optional(nullUnion([literal('md'), literal('inherit')])),
+});
+/**
+ * A struct for the {@link ButtonElement} type.
+ */
+export const ButtonStruct = element('Button', {
+    children: children([StringElementStruct, ImageStruct, IconStruct]),
+    name: optional(string()),
+    type: optional(nullUnion([literal('button'), literal('submit')])),
+    variant: optional(nullUnion([literal('primary'), literal('destructive')])),
+    disabled: optional(boolean()),
+});
+/**
+ * A struct for the {@link CheckboxElement} type.
+ */
+export const CheckboxStruct = element('Checkbox', {
+    name: string(),
+    checked: optional(boolean()),
+    label: optional(string()),
+    variant: optional(nullUnion([literal('default'), literal('toggle')])),
+});
+/**
+ * A struct for the {@link InputElement} type.
+ */
+export const InputStruct = element('Input', {
+    name: string(),
+    type: optional(nullUnion([literal('text'), literal('password'), literal('number')])),
+    value: optional(string()),
+    placeholder: optional(string()),
+});
+/**
+ * A struct for the {@link OptionElement} type.
+ */
+export const OptionStruct = element('Option', {
+    value: string(),
+    children: string(),
+});
+/**
+ * A struct for the {@link DropdownElement} type.
+ */
+export const DropdownStruct = element('Dropdown', {
+    name: string(),
+    value: optional(string()),
+    children: children([OptionStruct]),
+});
+/**
+ * A struct for the {@link CardElement} type.
+ */
+export const CardStruct = element('Card', {
+    image: optional(string()),
+    title: string(),
+    description: optional(string()),
+    value: string(),
+    extra: optional(string()),
+});
+/**
+ * A struct for the {@link SelectorOptionElement} type.
+ */
+export const SelectorOptionStruct = element('SelectorOption', {
+    value: string(),
+    children: CardStruct,
+});
+/**
+ * A struct for the {@link SelectorElement} type.
+ */
+export const SelectorStruct = element('Selector', {
+    name: string(),
+    title: string(),
+    value: optional(string()),
+    children: children([SelectorOptionStruct]),
+});
+/**
+ * A struct for the {@link RadioElement} type.
+ */
+export const RadioStruct = element('Radio', {
+    value: string(),
+    children: string(),
+});
+/**
+ * A struct for the {@link RadioGroupElement} type.
+ */
+export const RadioGroupStruct = element('RadioGroup', {
+    name: string(),
+    value: optional(string()),
+    children: children([RadioStruct]),
+});
+/**
+ * A struct for the {@link FileInputElement} type.
+ */
+export const FileInputStruct = element('FileInput', {
+    name: string(),
+    accept: nullUnion([optional(array(string()))]),
+    compact: optional(boolean()),
+});
+/**
+ * A subset of JSX elements that represent the tuple Box + Input of the Field children.
+ */
+// eslint-disable-next-line @typescript-eslint/no-use-before-define
+const BOX_INPUT_LEFT = [lazy(() => BoxChildStruct), InputStruct];
+/**
+ * A subset of JSX elements that represent the tuple Input + Box of the Field children.
+ */
+// eslint-disable-next-line @typescript-eslint/no-use-before-define
+const BOX_INPUT_RIGHT = [InputStruct, lazy(() => BoxChildStruct)];
+/**
+ * A subset of JSX elements that represent the tuple Box + Input + Box of the Field children.
+ */
+const BOX_INPUT_BOTH = [
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define
+    lazy(() => BoxChildStruct),
+    InputStruct,
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define
+    lazy(() => BoxChildStruct),
+];
+/**
+ * A subset of JSX elements that are allowed as single children of the Field component.
+ */
+const FIELD_CHILDREN_ARRAY = [
+    InputStruct,
+    DropdownStruct,
+    RadioGroupStruct,
+    FileInputStruct,
+    CheckboxStruct,
+    SelectorStruct,
+];
+/**
+ * A union of the allowed children of the Field component.
+ * This is mainly used in the simulator for validation purposes.
+ */
+export const FieldChildUnionStruct = nullUnion([
+    ...FIELD_CHILDREN_ARRAY,
+    ...BOX_INPUT_LEFT,
+    ...BOX_INPUT_RIGHT,
+    ...BOX_INPUT_BOTH,
+]);
+/**
+ * A subset of JSX elements that are allowed as children of the Field component.
+ */
+const FieldChildStruct = nullUnion([
+    tuple(BOX_INPUT_LEFT),
+    tuple(BOX_INPUT_RIGHT),
+    tuple(BOX_INPUT_BOTH),
+    ...FIELD_CHILDREN_ARRAY,
+]);
+/**
+ * A struct for the {@link FieldElement} type.
+ */
+export const FieldStruct = element('Field', {
+    label: optional(string()),
+    error: optional(string()),
+    children: FieldChildStruct,
+});
+/**
+ * A subset of JSX elements that are allowed as children of the Form component.
+ */
+export const FormChildStruct = children(
+// eslint-disable-next-line @typescript-eslint/no-use-before-define
+[FieldStruct, lazy(() => BoxChildStruct)]);
+/**
+ * A struct for the {@link FormElement} type.
+ */
+export const FormStruct = element('Form', {
+    children: FormChildStruct,
+    name: string(),
+});
+/**
+ * A struct for the {@link BoldElement} type.
+ */
+export const BoldStruct = element('Bold', {
+    children: children([
+        string(),
+        // eslint-disable-next-line @typescript-eslint/no-use-before-define
+        lazy(() => ItalicStruct),
+    ]),
+});
+/**
+ * A struct for the {@link ItalicElement} type.
+ */
+export const ItalicStruct = element('Italic', {
+    children: children([
+        string(),
+        // eslint-disable-next-line @typescript-eslint/no-use-before-define
+        lazy(() => BoldStruct),
+    ]),
+});
+export const FormattingStruct = typedUnion([BoldStruct, ItalicStruct]);
+/**
+ * A struct for the {@link AddressElement} type.
+ */
+export const AddressStruct = element('Address', {
+    address: nullUnion([HexChecksumAddressStruct, CaipAccountIdStruct]),
+});
+export const BoxChildrenStruct = children(
+// eslint-disable-next-line @typescript-eslint/no-use-before-define
+[lazy(() => BoxChildStruct)]);
+/**
+ * A struct for the {@link BoxElement} type.
+ */
+export const BoxStruct = element('Box', {
+    children: BoxChildrenStruct,
+    direction: optional(nullUnion([literal('horizontal'), literal('vertical')])),
+    alignment: optional(nullUnion([
+        literal('start'),
+        literal('center'),
+        literal('end'),
+        literal('space-between'),
+        literal('space-around'),
+    ])),
+});
+const FooterButtonStruct = refine(ButtonStruct, 'FooterButton', (value) => {
+    if (typeof value.props.children === 'string' ||
+        typeof value.props.children === 'boolean' ||
+        value.props.children === null) {
+        return true;
+    }
+    if (Array.isArray(value.props.children)) {
+        const hasNonTextElements = value.props.children.some((child) => typeof child !== 'string' &&
+            typeof child !== 'boolean' &&
+            child !== null);
+        if (!hasNonTextElements) {
+            return true;
+        }
+    }
+    return 'Footer buttons may only contain text.';
+});
+/**
+ * A struct for the {@link SectionElement} type.
+ */
+export const SectionStruct = element('Section', {
+    children: BoxChildrenStruct,
+    direction: optional(nullUnion([literal('horizontal'), literal('vertical')])),
+    alignment: optional(nullUnion([
+        literal('start'),
+        literal('center'),
+        literal('end'),
+        literal('space-between'),
+        literal('space-around'),
+    ])),
+});
+/**
+ * A subset of JSX elements that are allowed as children of the Footer component.
+ * This set should include a single button or a tuple of two buttons.
+ */
+export const FooterChildStruct = selectiveUnion((value) => {
+    if (Array.isArray(value)) {
+        return tuple([FooterButtonStruct, FooterButtonStruct]);
+    }
+    return FooterButtonStruct;
+});
+/**
+ * A struct for the {@link FooterElement} type.
+ */
+export const FooterStruct = element('Footer', {
+    children: FooterChildStruct,
+});
+/**
+ * A struct for the {@link CopyableElement} type.
+ */
+export const CopyableStruct = element('Copyable', {
+    value: string(),
+    sensitive: optional(boolean()),
+});
+/**
+ * A struct for the {@link DividerElement} type.
+ */
+export const DividerStruct = element('Divider');
+/**
+ * A struct for the {@link ValueElement} type.
+ */
+export const ValueStruct = element('Value', {
+    value: string(),
+    extra: string(),
+});
+/**
+ * A struct for the {@link HeadingElement} type.
+ */
+export const HeadingStruct = element('Heading', {
+    children: StringElementStruct,
+});
+/**
+ * A struct for the {@link LinkElement} type.
+ */
+export const LinkStruct = element('Link', {
+    href: string(),
+    children: children([FormattingStruct, string()]),
+});
+/**
+ * A struct for the {@link TextElement} type.
+ */
+export const TextStruct = element('Text', {
+    children: children([
+        selectiveUnion((value) => {
+            if (typeof value === 'string') {
+                return string();
+            }
+            return typedUnion([BoldStruct, ItalicStruct, LinkStruct, IconStruct]);
+        }),
+    ]),
+    alignment: optional(nullUnion([literal('start'), literal('center'), literal('end')])),
+    color: optional(nullUnion([
+        literal('default'),
+        literal('alternative'),
+        literal('muted'),
+        literal('error'),
+        literal('success'),
+        literal('warning'),
+    ])),
+});
+/**
+ * A subset of JSX elements that are allowed as children of the Tooltip component.
+ * This set should include all text components and the Image.
+ */
+export const TooltipChildStruct = selectiveUnion((value) => {
+    if (typeof value === 'boolean') {
+        return boolean();
+    }
+    return typedUnion([
+        TextStruct,
+        BoldStruct,
+        ItalicStruct,
+        LinkStruct,
+        ImageStruct,
+        IconStruct,
+    ]);
+});
+/**
+ * A subset of JSX elements that are allowed as content of the Tooltip component.
+ * This set should include all text components.
+ */
+export const TooltipContentStruct = selectiveUnion((value) => {
+    if (typeof value === 'string') {
+        return string();
+    }
+    return typedUnion([
+        TextStruct,
+        BoldStruct,
+        ItalicStruct,
+        LinkStruct,
+        IconStruct,
+    ]);
+});
+/**
+ * A struct for the {@link TooltipElement} type.
+ */
+export const TooltipStruct = element('Tooltip', {
+    children: nullable(TooltipChildStruct),
+    content: TooltipContentStruct,
+});
+/**
+ * A struct for the {@link RowElement} type.
+ */
+export const RowStruct = element('Row', {
+    label: string(),
+    children: typedUnion([AddressStruct, ImageStruct, TextStruct, ValueStruct]),
+    variant: optional(nullUnion([literal('default'), literal('warning'), literal('critical')])),
+    tooltip: optional(string()),
+});
+/**
+ * A struct for the {@link SpinnerElement} type.
+ */
+export const SpinnerStruct = element('Spinner');
+/**
+ * A subset of JSX elements that are allowed as children of the Box component.
+ * This set includes all components, except components that need to be nested in
+ * another component (e.g., Field must be contained in a Form).
+ */
+export const BoxChildStruct = typedUnion([
+    AddressStruct,
+    BoldStruct,
+    BoxStruct,
+    ButtonStruct,
+    CopyableStruct,
+    DividerStruct,
+    DropdownStruct,
+    RadioGroupStruct,
+    FileInputStruct,
+    FormStruct,
+    HeadingStruct,
+    InputStruct,
+    ImageStruct,
+    ItalicStruct,
+    LinkStruct,
+    RowStruct,
+    SpinnerStruct,
+    TextStruct,
+    TooltipStruct,
+    CheckboxStruct,
+    CardStruct,
+    IconStruct,
+    SelectorStruct,
+    SectionStruct,
+]);
+/**
+ * A struct for the {@link ContainerElement} type.
+ */
+export const ContainerStruct = element('Container', {
+    children: selectiveUnion((value) => {
+        if (Array.isArray(value)) {
+            return tuple([BoxChildStruct, FooterStruct]);
+        }
+        return BoxChildStruct;
+    }),
+});
+/**
+ * For now, the allowed JSX elements at the root are the same as the allowed
+ * children of the Box component.
+ */
+export const RootJSXElementStruct = typedUnion([
+    BoxChildStruct,
+    ContainerStruct,
+]);
+/**
+ * A struct for the {@link JSXElement} type.
+ */
+export const JSXElementStruct = typedUnion([
+    ButtonStruct,
+    InputStruct,
+    FileInputStruct,
+    FieldStruct,
+    FormStruct,
+    BoldStruct,
+    ItalicStruct,
+    AddressStruct,
+    BoxStruct,
+    CopyableStruct,
+    DividerStruct,
+    HeadingStruct,
+    ImageStruct,
+    LinkStruct,
+    RowStruct,
+    SpinnerStruct,
+    TextStruct,
+    DropdownStruct,
+    OptionStruct,
+    RadioGroupStruct,
+    RadioStruct,
+    ValueStruct,
+    TooltipStruct,
+    CheckboxStruct,
+    FooterStruct,
+    ContainerStruct,
+    CardStruct,
+    IconStruct,
+    SelectorStruct,
+    SelectorOptionStruct,
+    SectionStruct,
+]);
+/**
+ * Check if a value is a JSX element.
+ *
+ * @param value - The value to check.
+ * @returns True if the value is a JSX element, false otherwise.
+ */
+export function isJSXElement(value) {
+    return is(value, JSXElementStruct);
+}
+/**
+ * Check if a value is a JSX element, without validating all of its contents.
+ * This is useful when you want to validate the structure of a value, but not
+ * all the children.
+ *
+ * This should only be used when you are sure that the value is safe to use,
+ * i.e., after using {@link isJSXElement}.
+ *
+ * @param value - The value to check.
+ * @returns True if the value is a JSX element, false otherwise.
+ */
+export function isJSXElementUnsafe(value) {
+    return (isPlainObject(value) &&
+        hasProperty(value, 'type') &&
+        hasProperty(value, 'props') &&
+        hasProperty(value, 'key'));
+}
+/**
+ * Assert that a value is a JSX element.
+ *
+ * @param value - The value to check.
+ * @throws If the value is not a JSX element.
+ */
+export function assertJSXElement(value) {
+    // TODO: We should use the error parsing utils from `snaps-utils` to improve
+    // the error messages. It currently includes colours and potentially other
+    // formatting that we might not want to include in the SDK.
+    if (!isJSXElement(value)) {
+        throw new Error(`Expected a JSX element, but received ${JSON.stringify(value)}. Please refer to the documentation for the supported JSX elements and their props.`);
+    }
+}
+//# sourceMappingURL=validation.mjs.map

package/dist/jsx/validation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.mjs","sourceRoot":"","sources":["../../src/jsx/validation.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AnyStruct,\n  Infer,\n  InferStructTuple,\n  ObjectSchema,\n  Struct,\n} from '@metamask/superstruct';\nimport {\n  is,\n  boolean,\n  optional,\n  array,\n  lazy,\n  nullable,\n  number,\n  object,\n  record,\n  string,\n  tuple,\n  refine,\n} from '@metamask/superstruct';\nimport {\n  CaipAccountIdStruct,\n  hasProperty,\n  HexChecksumAddressStruct,\n  isPlainObject,\n  JsonStruct,\n} from '@metamask/utils';\n\nimport type { Describe } from '../internals';\nimport {\n  literal,\n  nullUnion,\n  selectiveUnion,\n  svg,\n  typedUnion,\n} from '../internals';\nimport type { EmptyObject } from '../types';\nimport type {\n  GenericSnapElement,\n  JsonObject,\n  Key,\n  Nestable,\n  SnapElement,\n  SnapsChildren,\n  StringElement,\n} from './component';\nimport {\n  type AddressElement,\n  type BoldElement,\n  type BoxElement,\n  type ButtonElement,\n  type CheckboxElement,\n  type CardElement,\n  type CopyableElement,\n  type DividerElement,\n  type DropdownElement,\n  type OptionElement,\n  type RadioElement,\n  type RadioGroupElement,\n  type FieldElement,\n  type FormElement,\n  type HeadingElement,\n  type ImageElement,\n  type InputElement,\n  type ItalicElement,\n  type JSXElement,\n  type LinkElement,\n  type RowElement,\n  type SpinnerElement,\n  type StandardFormattingElement,\n  type TextElement,\n  type TooltipElement,\n  type ValueElement,\n  type FileInputElement,\n  type ContainerElement,\n  type FooterElement,\n  type IconElement,\n  type SectionElement,\n  type SelectorElement,\n  type SelectorOptionElement,\n  IconName,\n} from './components';\n\n/**\n * A struct for the {@link Key} type.\n */\nexport const KeyStruct: Describe<Key> = nullUnion([string(), number()]);\n\n/**\n * A struct for the {@link StringElement} type.\n */\nexport const StringElementStruct: Describe<StringElement> = children([\n  string(),\n]);\n\n/**\n * A struct for the {@link GenericSnapElement} type.\n */\nexport const ElementStruct: Describe<GenericSnapElement> = object({\n  type: string(),\n  props: record(string(), JsonStruct),\n  key: nullable(KeyStruct),\n});\n\n/**\n * A helper function for creating a struct for a {@link Nestable} type.\n *\n * @param struct - The struct for the type to test.\n * @returns The struct for the nestable type.\n */\nfunction nestable<Type, Schema>(\n  struct: Struct<Type, Schema>,\n): Struct<Nestable<Type>, any> {\n  const nestableStruct: Struct<Nestable<Type>> = selectiveUnion((value) => {\n    if (Array.isArray(value)) {\n      return array(lazy(() => nestableStruct));\n    }\n    return struct;\n  });\n\n  return nestableStruct;\n}\n\n/**\n * A helper function for creating a struct which allows children of a specific\n * type, as well as `null` and `boolean`.\n *\n * @param structs - The structs to allow as children.\n * @returns The struct for the children.\n */\nfunction children<Head extends AnyStruct, Tail extends AnyStruct[]>(\n  structs: [head: Head, ...tail: Tail],\n): Struct<\n  Nestable<Infer<Head> | InferStructTuple<Tail>[number] | boolean | null>,\n  null\n> {\n  return nestable(\n    nullable(\n      selectiveUnion((value) => {\n        if (typeof value === 'boolean') {\n          return boolean();\n        }\n        if (structs.length === 1) {\n          return structs[0];\n        }\n        return nullUnion(structs);\n      }),\n    ),\n  ) as unknown as Struct<\n    Nestable<Infer<Head> | InferStructTuple<Tail>[number] | boolean | null>,\n    null\n  >;\n}\n\n/**\n * A helper function for creating a struct for a JSX element.\n *\n * @param name - The name of the element.\n * @param props - The props of the element.\n * @returns The struct for the element.\n */\nfunction element<Name extends string, Props extends ObjectSchema = EmptyObject>(\n  name: Name,\n  props: Props = {} as Props,\n) {\n  return object({\n    type: literal(name) as unknown as Struct<Name, Name>,\n    props: object(props),\n    key: nullable(KeyStruct),\n  });\n}\n\n/**\n * A struct for the {@link ImageElement} type.\n */\nexport const ImageStruct: Describe<ImageElement> = element('Image', {\n  src: svg(),\n  alt: optional(string()),\n});\n\nconst IconNameStruct: Struct<`${IconName}`, null> = nullUnion(\n  Object.values(IconName).map((name) => literal(name)) as any,\n);\n\n/**\n * A struct for the {@link IconElement} type.\n */\nexport const IconStruct: Describe<IconElement> = element('Icon', {\n  name: IconNameStruct,\n  color: optional(\n    nullUnion([literal('default'), literal('primary'), literal('muted')]),\n  ),\n  size: optional(nullUnion([literal('md'), literal('inherit')])),\n});\n\n/**\n * A struct for the {@link ButtonElement} type.\n */\nexport const ButtonStruct: Describe<ButtonElement> = element('Button', {\n  children: children([StringElementStruct, ImageStruct, IconStruct]),\n  name: optional(string()),\n  type: optional(nullUnion([literal('button'), literal('submit')])),\n  variant: optional(nullUnion([literal('primary'), literal('destructive')])),\n  disabled: optional(boolean()),\n});\n\n/**\n * A struct for the {@link CheckboxElement} type.\n */\nexport const CheckboxStruct: Describe<CheckboxElement> = element('Checkbox', {\n  name: string(),\n  checked: optional(boolean()),\n  label: optional(string()),\n  variant: optional(nullUnion([literal('default'), literal('toggle')])),\n});\n\n/**\n * A struct for the {@link InputElement} type.\n */\nexport const InputStruct: Describe<InputElement> = element('Input', {\n  name: string(),\n  type: optional(\n    nullUnion([literal('text'), literal('password'), literal('number')]),\n  ),\n  value: optional(string()),\n  placeholder: optional(string()),\n});\n\n/**\n * A struct for the {@link OptionElement} type.\n */\nexport const OptionStruct: Describe<OptionElement> = element('Option', {\n  value: string(),\n  children: string(),\n});\n\n/**\n * A struct for the {@link DropdownElement} type.\n */\nexport const DropdownStruct: Describe<DropdownElement> = element('Dropdown', {\n  name: string(),\n  value: optional(string()),\n  children: children([OptionStruct]),\n});\n\n/**\n * A struct for the {@link CardElement} type.\n */\nexport const CardStruct: Describe<CardElement> = element('Card', {\n  image: optional(string()),\n  title: string(),\n  description: optional(string()),\n  value: string(),\n  extra: optional(string()),\n});\n\n/**\n * A struct for the {@link SelectorOptionElement} type.\n */\nexport const SelectorOptionStruct: Describe<SelectorOptionElement> = element(\n  'SelectorOption',\n  {\n    value: string(),\n    children: CardStruct,\n  },\n);\n\n/**\n * A struct for the {@link SelectorElement} type.\n */\nexport const SelectorStruct: Describe<SelectorElement> = element('Selector', {\n  name: string(),\n  title: string(),\n  value: optional(string()),\n  children: children([SelectorOptionStruct]),\n});\n\n/**\n * A struct for the {@link RadioElement} type.\n */\nexport const RadioStruct: Describe<RadioElement> = element('Radio', {\n  value: string(),\n  children: string(),\n});\n\n/**\n * A struct for the {@link RadioGroupElement} type.\n */\nexport const RadioGroupStruct: Describe<RadioGroupElement> = element(\n  'RadioGroup',\n  {\n    name: string(),\n    value: optional(string()),\n    children: children([RadioStruct]),\n  },\n);\n\n/**\n * A struct for the {@link FileInputElement} type.\n */\nexport const FileInputStruct: Describe<FileInputElement> = element(\n  'FileInput',\n  {\n    name: string(),\n    accept: nullUnion([optional(array(string()))]),\n    compact: optional(boolean()),\n  },\n);\n\n/**\n * A subset of JSX elements that represent the tuple Box + Input of the Field children.\n */\n// eslint-disable-next-line @typescript-eslint/no-use-before-define\nconst BOX_INPUT_LEFT = [lazy(() => BoxChildStruct), InputStruct] as [\n  typeof BoxChildStruct,\n  typeof InputStruct,\n];\n\n/**\n * A subset of JSX elements that represent the tuple Input + Box of the Field children.\n */\n// eslint-disable-next-line @typescript-eslint/no-use-before-define\nconst BOX_INPUT_RIGHT = [InputStruct, lazy(() => BoxChildStruct)] as [\n  typeof InputStruct,\n  typeof BoxChildStruct,\n];\n\n/**\n * A subset of JSX elements that represent the tuple Box + Input + Box of the Field children.\n */\nconst BOX_INPUT_BOTH = [\n  // eslint-disable-next-line @typescript-eslint/no-use-before-define\n  lazy(() => BoxChildStruct),\n  InputStruct,\n  // eslint-disable-next-line @typescript-eslint/no-use-before-define\n  lazy(() => BoxChildStruct),\n] as [typeof BoxChildStruct, typeof InputStruct, typeof BoxChildStruct];\n\n/**\n * A subset of JSX elements that are allowed as single children of the Field component.\n */\nconst FIELD_CHILDREN_ARRAY = [\n  InputStruct,\n  DropdownStruct,\n  RadioGroupStruct,\n  FileInputStruct,\n  CheckboxStruct,\n  SelectorStruct,\n] as [\n  typeof InputStruct,\n  typeof DropdownStruct,\n  typeof RadioGroupStruct,\n  typeof FileInputStruct,\n  typeof CheckboxStruct,\n  typeof SelectorStruct,\n];\n\n/**\n * A union of the allowed children of the Field component.\n * This is mainly used in the simulator for validation purposes.\n */\nexport const FieldChildUnionStruct = nullUnion([\n  ...FIELD_CHILDREN_ARRAY,\n  ...BOX_INPUT_LEFT,\n  ...BOX_INPUT_RIGHT,\n  ...BOX_INPUT_BOTH,\n]);\n\n/**\n * A subset of JSX elements that are allowed as children of the Field component.\n */\nconst FieldChildStruct = nullUnion([\n  tuple(BOX_INPUT_LEFT),\n  tuple(BOX_INPUT_RIGHT),\n  tuple(BOX_INPUT_BOTH),\n  ...FIELD_CHILDREN_ARRAY,\n]) as unknown as Struct<\n  | [InputElement, GenericSnapElement]\n  | [GenericSnapElement, InputElement]\n  | [GenericSnapElement, InputElement, GenericSnapElement]\n  | DropdownElement\n  | RadioGroupElement\n  | FileInputElement\n  | InputElement\n  | CheckboxElement\n  | SelectorElement,\n  null\n>;\n\n/**\n * A struct for the {@link FieldElement} type.\n */\nexport const FieldStruct: Describe<FieldElement> = element('Field', {\n  label: optional(string()),\n  error: optional(string()),\n  children: FieldChildStruct,\n});\n\n/**\n * A subset of JSX elements that are allowed as children of the Form component.\n */\nexport const FormChildStruct = children(\n  // eslint-disable-next-line @typescript-eslint/no-use-before-define\n  [FieldStruct, lazy(() => BoxChildStruct)],\n) as unknown as Struct<SnapsChildren<GenericSnapElement>, null>;\n\n/**\n * A struct for the {@link FormElement} type.\n */\nexport const FormStruct: Describe<FormElement> = element('Form', {\n  children: FormChildStruct,\n  name: string(),\n});\n\n/**\n * A struct for the {@link BoldElement} type.\n */\nexport const BoldStruct: Describe<BoldElement> = element('Bold', {\n  children: children([\n    string(),\n    // eslint-disable-next-line @typescript-eslint/no-use-before-define\n    lazy(() => ItalicStruct) as unknown as Struct<\n      SnapElement<JsonObject, 'Italic'>\n    >,\n  ]),\n});\n\n/**\n * A struct for the {@link ItalicElement} type.\n */\nexport const ItalicStruct: Describe<ItalicElement> = element('Italic', {\n  children: children([\n    string(),\n    // eslint-disable-next-line @typescript-eslint/no-use-before-define\n    lazy(() => BoldStruct) as unknown as Struct<\n      SnapElement<JsonObject, 'Bold'>\n    >,\n  ]),\n});\n\nexport const FormattingStruct: Describe<StandardFormattingElement> = typedUnion(\n  [BoldStruct, ItalicStruct],\n);\n\n/**\n * A struct for the {@link AddressElement} type.\n */\nexport const AddressStruct: Describe<AddressElement> = element('Address', {\n  address: nullUnion([HexChecksumAddressStruct, CaipAccountIdStruct]),\n});\n\nexport const BoxChildrenStruct = children(\n  // eslint-disable-next-line @typescript-eslint/no-use-before-define\n  [lazy(() => BoxChildStruct)],\n) as unknown as Struct<SnapsChildren<GenericSnapElement>, null>;\n\n/**\n * A struct for the {@link BoxElement} type.\n */\nexport const BoxStruct: Describe<BoxElement> = element('Box', {\n  children: BoxChildrenStruct,\n  direction: optional(nullUnion([literal('horizontal'), literal('vertical')])),\n  alignment: optional(\n    nullUnion([\n      literal('start'),\n      literal('center'),\n      literal('end'),\n      literal('space-between'),\n      literal('space-around'),\n    ]),\n  ),\n});\n\nconst FooterButtonStruct = refine(ButtonStruct, 'FooterButton', (value) => {\n  if (\n    typeof value.props.children === 'string' ||\n    typeof value.props.children === 'boolean' ||\n    value.props.children === null\n  ) {\n    return true;\n  }\n\n  if (Array.isArray(value.props.children)) {\n    const hasNonTextElements = value.props.children.some(\n      (child) =>\n        typeof child !== 'string' &&\n        typeof child !== 'boolean' &&\n        child !== null,\n    );\n\n    if (!hasNonTextElements) {\n      return true;\n    }\n  }\n\n  return 'Footer buttons may only contain text.';\n});\n\n/**\n * A struct for the {@link SectionElement} type.\n */\nexport const SectionStruct: Describe<SectionElement> = element('Section', {\n  children: BoxChildrenStruct,\n  direction: optional(nullUnion([literal('horizontal'), literal('vertical')])),\n  alignment: optional(\n    nullUnion([\n      literal('start'),\n      literal('center'),\n      literal('end'),\n      literal('space-between'),\n      literal('space-around'),\n    ]),\n  ),\n});\n\n/**\n * A subset of JSX elements that are allowed as children of the Footer component.\n * This set should include a single button or a tuple of two buttons.\n */\n\nexport const FooterChildStruct = selectiveUnion((value) => {\n  if (Array.isArray(value)) {\n    return tuple([FooterButtonStruct, FooterButtonStruct]);\n  }\n  return FooterButtonStruct;\n});\n\n/**\n * A struct for the {@link FooterElement} type.\n */\nexport const FooterStruct: Describe<FooterElement> = element('Footer', {\n  children: FooterChildStruct,\n});\n\n/**\n * A struct for the {@link CopyableElement} type.\n */\nexport const CopyableStruct: Describe<CopyableElement> = element('Copyable', {\n  value: string(),\n  sensitive: optional(boolean()),\n});\n\n/**\n * A struct for the {@link DividerElement} type.\n */\nexport const DividerStruct: Describe<DividerElement> = element('Divider');\n\n/**\n * A struct for the {@link ValueElement} type.\n */\nexport const ValueStruct: Describe<ValueElement> = element('Value', {\n  value: string(),\n  extra: string(),\n});\n\n/**\n * A struct for the {@link HeadingElement} type.\n */\nexport const HeadingStruct: Describe<HeadingElement> = element('Heading', {\n  children: StringElementStruct,\n});\n\n/**\n * A struct for the {@link LinkElement} type.\n */\nexport const LinkStruct: Describe<LinkElement> = element('Link', {\n  href: string(),\n  children: children([FormattingStruct, string()]),\n});\n\n/**\n * A struct for the {@link TextElement} type.\n */\nexport const TextStruct: Describe<TextElement> = element('Text', {\n  children: children([\n    selectiveUnion((value) => {\n      if (typeof value === 'string') {\n        return string();\n      }\n      return typedUnion([BoldStruct, ItalicStruct, LinkStruct, IconStruct]);\n    }),\n  ]),\n  alignment: optional(\n    nullUnion([literal('start'), literal('center'), literal('end')]),\n  ),\n  color: optional(\n    nullUnion([\n      literal('default'),\n      literal('alternative'),\n      literal('muted'),\n      literal('error'),\n      literal('success'),\n      literal('warning'),\n    ]),\n  ),\n});\n\n/**\n * A subset of JSX elements that are allowed as children of the Tooltip component.\n * This set should include all text components and the Image.\n */\nexport const TooltipChildStruct = selectiveUnion((value) => {\n  if (typeof value === 'boolean') {\n    return boolean();\n  }\n  return typedUnion([\n    TextStruct,\n    BoldStruct,\n    ItalicStruct,\n    LinkStruct,\n    ImageStruct,\n    IconStruct,\n  ]);\n});\n\n/**\n * A subset of JSX elements that are allowed as content of the Tooltip component.\n * This set should include all text components.\n */\nexport const TooltipContentStruct = selectiveUnion((value) => {\n  if (typeof value === 'string') {\n    return string();\n  }\n  return typedUnion([\n    TextStruct,\n    BoldStruct,\n    ItalicStruct,\n    LinkStruct,\n    IconStruct,\n  ]);\n});\n\n/**\n * A struct for the {@link TooltipElement} type.\n */\nexport const TooltipStruct: Describe<TooltipElement> = element('Tooltip', {\n  children: nullable(TooltipChildStruct),\n  content: TooltipContentStruct,\n});\n\n/**\n * A struct for the {@link RowElement} type.\n */\nexport const RowStruct: Describe<RowElement> = element('Row', {\n  label: string(),\n  children: typedUnion([AddressStruct, ImageStruct, TextStruct, ValueStruct]),\n  variant: optional(\n    nullUnion([literal('default'), literal('warning'), literal('critical')]),\n  ),\n  tooltip: optional(string()),\n});\n\n/**\n * A struct for the {@link SpinnerElement} type.\n */\nexport const SpinnerStruct: Describe<SpinnerElement> = element('Spinner');\n\n/**\n * A subset of JSX elements that are allowed as children of the Box component.\n * This set includes all components, except components that need to be nested in\n * another component (e.g., Field must be contained in a Form).\n */\nexport const BoxChildStruct = typedUnion([\n  AddressStruct,\n  BoldStruct,\n  BoxStruct,\n  ButtonStruct,\n  CopyableStruct,\n  DividerStruct,\n  DropdownStruct,\n  RadioGroupStruct,\n  FileInputStruct,\n  FormStruct,\n  HeadingStruct,\n  InputStruct,\n  ImageStruct,\n  ItalicStruct,\n  LinkStruct,\n  RowStruct,\n  SpinnerStruct,\n  TextStruct,\n  TooltipStruct,\n  CheckboxStruct,\n  CardStruct,\n  IconStruct,\n  SelectorStruct,\n  SectionStruct,\n]);\n\n/**\n * A struct for the {@link ContainerElement} type.\n */\nexport const ContainerStruct: Describe<ContainerElement> = element(\n  'Container',\n  {\n    children: selectiveUnion((value) => {\n      if (Array.isArray(value)) {\n        return tuple([BoxChildStruct, FooterStruct]);\n      }\n      return BoxChildStruct;\n    }) as unknown as Struct<\n      [GenericSnapElement, FooterElement] | GenericSnapElement,\n      null\n    >,\n  },\n);\n\n/**\n * For now, the allowed JSX elements at the root are the same as the allowed\n * children of the Box component.\n */\nexport const RootJSXElementStruct = typedUnion([\n  BoxChildStruct,\n  ContainerStruct,\n]);\n\n/**\n * A struct for the {@link JSXElement} type.\n */\nexport const JSXElementStruct: Describe<JSXElement> = typedUnion([\n  ButtonStruct,\n  InputStruct,\n  FileInputStruct,\n  FieldStruct,\n  FormStruct,\n  BoldStruct,\n  ItalicStruct,\n  AddressStruct,\n  BoxStruct,\n  CopyableStruct,\n  DividerStruct,\n  HeadingStruct,\n  ImageStruct,\n  LinkStruct,\n  RowStruct,\n  SpinnerStruct,\n  TextStruct,\n  DropdownStruct,\n  OptionStruct,\n  RadioGroupStruct,\n  RadioStruct,\n  ValueStruct,\n  TooltipStruct,\n  CheckboxStruct,\n  FooterStruct,\n  ContainerStruct,\n  CardStruct,\n  IconStruct,\n  SelectorStruct,\n  SelectorOptionStruct,\n  SectionStruct,\n]);\n\n/**\n * Check if a value is a JSX element.\n *\n * @param value - The value to check.\n * @returns True if the value is a JSX element, false otherwise.\n */\nexport function isJSXElement(value: unknown): value is JSXElement {\n  return is(value, JSXElementStruct);\n}\n\n/**\n * Check if a value is a JSX element, without validating all of its contents.\n * This is useful when you want to validate the structure of a value, but not\n * all the children.\n *\n * This should only be used when you are sure that the value is safe to use,\n * i.e., after using {@link isJSXElement}.\n *\n * @param value - The value to check.\n * @returns True if the value is a JSX element, false otherwise.\n */\nexport function isJSXElementUnsafe(value: unknown): value is JSXElement {\n  return (\n    isPlainObject(value) &&\n    hasProperty(value, 'type') &&\n    hasProperty(value, 'props') &&\n    hasProperty(value, 'key')\n  );\n}\n\n/**\n * Assert that a value is a JSX element.\n *\n * @param value - The value to check.\n * @throws If the value is not a JSX element.\n */\nexport function assertJSXElement(value: unknown): asserts value is JSXElement {\n  // TODO: We should use the error parsing utils from `snaps-utils` to improve\n  // the error messages. It currently includes colours and potentially other\n  // formatting that we might not want to include in the SDK.\n  if (!isJSXElement(value)) {\n    throw new Error(\n      `Expected a JSX element, but received ${JSON.stringify(\n        value,\n      )}. Please refer to the documentation for the supported JSX elements and their props.`,\n    );\n  }\n}\n"]}

package/dist/types/caip.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=caip.cjs.map

package/dist/types/caip.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.cjs","sourceRoot":"","sources":["../../src/types/caip.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * A CAIP-2 chain ID, i.e., a human-readable namespace and reference.\n *\n * @see https://chainagnostic.org/CAIPs/caip-2\n */\nexport type ChainId = `${string}:${string}`;\n\n/**\n * A CAIP-10 account ID, i.e., a chain ID and an account address.\n *\n * @see https://chainagnostic.org/CAIPs/caip-10\n */\nexport type AccountId = `${ChainId}:${string}`;\n"]}

package/dist/types/{types/caip.d.ts → caip.d.cts}

@@ -10,3 +10,4 @@ export type ChainId = `${string}:${string}`;
  * @see https://chainagnostic.org/CAIPs/caip-10
  */
 export type AccountId = `${ChainId}:${string}`;
+//# sourceMappingURL=caip.d.cts.map

package/dist/types/caip.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.d.cts","sourceRoot":"","sources":["../../src/types/caip.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAE5C;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC"}

package/dist/types/caip.d.mts

@@ -0,0 +1,13 @@
+/**
+ * A CAIP-2 chain ID, i.e., a human-readable namespace and reference.
+ *
+ * @see https://chainagnostic.org/CAIPs/caip-2
+ */
+export type ChainId = `${string}:${string}`;
+/**
+ * A CAIP-10 account ID, i.e., a chain ID and an account address.
+ *
+ * @see https://chainagnostic.org/CAIPs/caip-10
+ */
+export type AccountId = `${ChainId}:${string}`;
+//# sourceMappingURL=caip.d.mts.map

package/dist/types/caip.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.d.mts","sourceRoot":"","sources":["../../src/types/caip.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAE5C;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC"}

package/dist/types/caip.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=caip.mjs.map