@azure/storage-file-share 12.32.0 → 12.33.0

package/dist/commonjs/generated/static-helpers/serialization/xml-helpers.d.ts

@@ -0,0 +1,146 @@
+import { XmlBuilderOptions } from "fast-xml-parser";
+/**
+ * XML serialization options for a property or model
+ */
+export interface XmlSerializationOptions {
+    /** Element or attribute name */
+    name: string;
+    /** If true, serialize as XML attribute instead of element */
+    attribute?: boolean;
+    /** XML namespace for this element/attribute */
+    ns?: {
+        namespace: string;
+        prefix: string;
+    };
+    /** For arrays - if true, items are inline without wrapper element */
+    unwrapped?: boolean;
+    /** For arrays - name of each item element */
+    itemsName?: string;
+    /** For arrays - namespace for item elements */
+    itemsNs?: {
+        namespace: string;
+        prefix: string;
+    };
+}
+/**
+ * Metadata for serializing a model property to XML
+ */
+export interface XmlPropertyMetadata {
+    /** Client-side property name */
+    propertyName: string;
+    /** XML serialization options */
+    xmlOptions: XmlSerializationOptions;
+    /** Serializer function for complex types */
+    serializer?: (value: any) => XmlSerializedValue;
+    /** Type of the property for special handling */
+    type?: "array" | "object" | "primitive" | "date" | "bytes" | "dict";
+    /** Date encoding format */
+    dateEncoding?: "rfc3339" | "rfc7231" | "unixTimestamp";
+    /** Bytes encoding format (base64 or base64url) */
+    bytesEncoding?: "base64" | "base64url";
+    /** For arrays - type of each item for special handling */
+    itemType?: "primitive" | "date" | "bytes";
+}
+/**
+ * Metadata for deserializing XML to a model property
+ */
+export interface XmlPropertyDeserializeMetadata {
+    /** Client-side property name */
+    propertyName: string;
+    /** XML serialization options */
+    xmlOptions: XmlSerializationOptions;
+    /** Deserializer function for complex types */
+    deserializer?: (value: any) => any;
+    /** Type of the property for special handling */
+    type?: "array" | "object" | "primitive" | "date" | "bytes" | "dict";
+    /** Subtype for primitive properties to drive type conversion from raw XML strings */
+    primitiveSubtype?: "string" | "number" | "boolean";
+    /** Date encoding format */
+    dateEncoding?: "rfc3339" | "rfc7231" | "unixTimestamp";
+    /** Bytes encoding format (base64 or base64url) */
+    bytesEncoding?: "base64" | "base64url";
+    /** For arrays - type of each item for special handling */
+    itemType?: "primitive" | "date" | "bytes";
+}
+/**
+ * Configuration for collecting additional (undeclared) XML elements
+ * into a Record property on the deserialized model.
+ */
+export interface XmlAdditionalPropertiesConfig {
+    /** Client-side property name to assign the collected record to */
+    propertyName: string;
+    /** XML element names of declared properties to exclude from collection */
+    excludeNames: string[];
+    /** Optional deserializer for complex value types */
+    deserializer?: (value: any) => any;
+}
+/**
+ * Result of XML serialization - either a primitive value or structured XML object
+ */
+export type XmlSerializedValue = string | number | boolean | null | undefined | XmlSerializedObject;
+export interface XmlSerializedObject {
+    [key: string]: XmlSerializedValue | XmlSerializedValue[];
+}
+declare const defaultParserOptions: {
+    ignoreAttributes: boolean;
+    attributeNamePrefix: string;
+    textNodeName: string;
+    parseTagValue: boolean;
+    parseAttributeValue: boolean;
+    trimValues: boolean;
+    isArray: (_name: string, _jpath: string | unknown, isLeafNode: boolean, isAttribute: boolean) => boolean;
+};
+/**
+ * Serializes a model to XML object structure
+ */
+export declare function serializeModelToXml(item: Record<string, any>, properties: XmlPropertyMetadata[], rootName: string, rootNs?: {
+    namespace: string;
+    prefix: string;
+}, additionalPropertiesConfig?: XmlAdditionalPropertiesConfig): XmlSerializedObject;
+/**
+ * Converts an XML object structure to XML string
+ */
+export declare function xmlObjectToString(xmlObject: XmlSerializedObject, options?: Partial<XmlBuilderOptions>): string;
+/**
+ * Full serialization: model to XML string
+ */
+export declare function serializeToXml(item: Record<string, any>, properties: XmlPropertyMetadata[], rootName: string, rootNs?: {
+    namespace: string;
+    prefix: string;
+}, options?: Partial<XmlBuilderOptions>, additionalPropertiesConfig?: XmlAdditionalPropertiesConfig): string;
+/**
+ * Parses XML string to object structure
+ */
+export declare function parseXmlString(xmlString: string, options?: Partial<typeof defaultParserOptions>): any;
+/**
+ * Deserializes XML object structure to model
+ */
+export declare function deserializeXmlToModel<T = Record<string, any>>(xmlObject: any, properties: XmlPropertyDeserializeMetadata[], rootName: string, rootNs?: {
+    namespace: string;
+    prefix: string;
+}, additionalPropertiesConfig?: XmlAdditionalPropertiesConfig): T;
+/**
+ * Full deserialization: XML string to model
+ */
+export declare function deserializeFromXml<T = Record<string, any>>(xmlString: string | undefined, properties: XmlPropertyDeserializeMetadata[], rootName: string, rootNs?: {
+    namespace: string;
+    prefix: string;
+}, parserOptions?: Partial<typeof defaultParserOptions>, additionalPropertiesConfig?: XmlAdditionalPropertiesConfig): T;
+/**
+ * Deserializes a pre-parsed XML object to a model.
+ * This is used for nested objects where the XML has already been parsed
+ * and we have the object content directly (without a root element wrapper).
+ * Unlike deserializeFromXml, this does not parse XML strings and does not
+ * expect a root element to unwrap.
+ */
+export declare function deserializeXmlObject<T = Record<string, any>>(xmlObject: Record<string, unknown>, properties: XmlPropertyDeserializeMetadata[], additionalPropertiesConfig?: XmlAdditionalPropertiesConfig): T;
+/**
+ * Utility to check if a content type is XML
+ */
+export declare function isXmlContentType(contentType: string): boolean;
+/**
+ * Utility to check if a content type is JSON
+ */
+export declare function isJsonContentType(contentType: string): boolean;
+export {};
+//# sourceMappingURL=xml-helpers.d.ts.map

package/dist/commonjs/generated/static-helpers/serialization/xml-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-helpers.d.ts","sourceRoot":"","sources":["../../../../../src/generated/static-helpers/serialization/xml-helpers.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/generated/static-helpers/serialization/xml-helpers.js

@@ -0,0 +1,421 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var xml_helpers_exports = {};
+__export(xml_helpers_exports, {
+  deserializeFromXml: () => deserializeFromXml,
+  deserializeXmlObject: () => deserializeXmlObject,
+  deserializeXmlToModel: () => deserializeXmlToModel,
+  isJsonContentType: () => isJsonContentType,
+  isXmlContentType: () => isXmlContentType,
+  parseXmlString: () => parseXmlString,
+  serializeModelToXml: () => serializeModelToXml,
+  serializeToXml: () => serializeToXml,
+  xmlObjectToString: () => xmlObjectToString
+});
+module.exports = __toCommonJS(xml_helpers_exports);
+var import_core_util = require("@azure/core-util");
+var import_fast_xml_parser = require("fast-xml-parser");
+const defaultParserOptions = {
+  ignoreAttributes: false,
+  attributeNamePrefix: "@_",
+  textNodeName: "#text",
+  parseTagValue: false,
+  parseAttributeValue: false,
+  trimValues: false,
+  // Preserve whitespace in text content
+  isArray: (_name, _jpath, isLeafNode, isAttribute) => {
+    return !isAttribute && !isLeafNode;
+  }
+};
+const defaultBuilderOptions = {
+  ignoreAttributes: false,
+  attributeNamePrefix: "@_",
+  textNodeName: "#text",
+  format: false,
+  suppressEmptyNode: true
+};
+function getElementName(name, ns) {
+  if (ns?.prefix) {
+    return `${ns.prefix}:${name}`;
+  }
+  return name;
+}
+function createNamespaceDeclarations(namespaces) {
+  const declarations = {};
+  for (const [prefix, namespace] of namespaces) {
+    if (prefix) {
+      declarations[`@_xmlns:${prefix}`] = namespace;
+    } else {
+      declarations["@_xmlns"] = namespace;
+    }
+  }
+  return declarations;
+}
+function collectNamespaces(properties, rootNs) {
+  const namespaces = /* @__PURE__ */ new Map();
+  if (rootNs) {
+    namespaces.set(rootNs.prefix, rootNs.namespace);
+  }
+  for (const prop of properties) {
+    if (prop.xmlOptions.ns) {
+      namespaces.set(prop.xmlOptions.ns.prefix, prop.xmlOptions.ns.namespace);
+    }
+    if (prop.xmlOptions.itemsNs) {
+      namespaces.set(prop.xmlOptions.itemsNs.prefix, prop.xmlOptions.itemsNs.namespace);
+    }
+  }
+  return namespaces;
+}
+function serializePrimitiveValue(value, type, dateEncoding, bytesEncoding) {
+  if (value === null || value === void 0) {
+    return "";
+  }
+  if (type === "date" && value instanceof Date) {
+    switch (dateEncoding) {
+      case "rfc7231":
+        return value.toUTCString();
+      case "unixTimestamp":
+        return Math.floor(value.getTime() / 1e3);
+      case "rfc3339":
+      default:
+        return value.toISOString();
+    }
+  }
+  if (type === "bytes" && value instanceof Uint8Array) {
+    return (0, import_core_util.uint8ArrayToString)(value, bytesEncoding ?? "base64");
+  }
+  if (typeof value === "boolean" || typeof value === "number") {
+    return value;
+  }
+  return String(value);
+}
+function serializeArrayProperty(value, metadata) {
+  const { xmlOptions, serializer } = metadata;
+  const itemName = getElementName(
+    xmlOptions.itemsName || xmlOptions.name,
+    xmlOptions.itemsNs || xmlOptions.ns
+  );
+  const serializedItems = value.map((item) => {
+    if (serializer) {
+      return serializer(item);
+    }
+    return serializePrimitiveValue(
+      item,
+      metadata.itemType ?? metadata.type,
+      metadata.dateEncoding,
+      metadata.bytesEncoding
+    );
+  });
+  if (xmlOptions.unwrapped) {
+    return serializedItems;
+  } else {
+    const wrapperName = getElementName(xmlOptions.name, xmlOptions.ns);
+    return {
+      [wrapperName]: {
+        [itemName]: serializedItems
+      }
+    };
+  }
+}
+function serializeModelToXml(item, properties, rootName, rootNs, additionalPropertiesConfig) {
+  if (item === null || item === void 0) {
+    return {};
+  }
+  const result = {};
+  const attributes = {};
+  const namespaces = collectNamespaces(properties, rootNs);
+  const nsDeclarations = createNamespaceDeclarations(namespaces);
+  Object.assign(attributes, nsDeclarations);
+  for (const prop of properties) {
+    const value = item[prop.propertyName];
+    if (value === void 0) {
+      continue;
+    }
+    const { xmlOptions, serializer, type } = prop;
+    const elementName = getElementName(xmlOptions.name, xmlOptions.ns);
+    if (xmlOptions.attribute) {
+      const attrName = xmlOptions.ns?.prefix ? `@_${xmlOptions.ns.prefix}:${xmlOptions.name}` : `@_${xmlOptions.name}`;
+      attributes[attrName] = serializePrimitiveValue(
+        value,
+        type,
+        prop.dateEncoding,
+        prop.bytesEncoding
+      );
+    } else if (type === "dict" && value !== null && typeof value === "object") {
+      const dictContent = {};
+      for (const [key, val] of Object.entries(value)) {
+        dictContent[key] = String(val);
+      }
+      result[elementName] = dictContent;
+    } else if (Array.isArray(value)) {
+      const arrayResult = serializeArrayProperty(value, prop);
+      if (xmlOptions.unwrapped && Array.isArray(arrayResult)) {
+        const itemName = getElementName(
+          xmlOptions.itemsName || xmlOptions.name,
+          xmlOptions.itemsNs || xmlOptions.ns
+        );
+        result[itemName] = arrayResult;
+      } else {
+        Object.assign(result, arrayResult);
+      }
+    } else if (value !== null && typeof value === "object" && serializer) {
+      result[elementName] = serializer(value);
+    } else if (xmlOptions.unwrapped && !Array.isArray(value)) {
+      result["#text"] = serializePrimitiveValue(value, type, prop.dateEncoding, prop.bytesEncoding);
+    } else {
+      result[elementName] = serializePrimitiveValue(
+        value,
+        type,
+        prop.dateEncoding,
+        prop.bytesEncoding
+      );
+    }
+  }
+  if (additionalPropertiesConfig) {
+    const apValue = item[additionalPropertiesConfig.propertyName];
+    if (apValue && typeof apValue === "object") {
+      for (const [key, val] of Object.entries(apValue)) {
+        result[key] = additionalPropertiesConfig.deserializer ? additionalPropertiesConfig.deserializer(val) : String(val);
+      }
+    }
+  }
+  Object.assign(result, attributes);
+  const rootElementName = getElementName(rootName, rootNs);
+  return {
+    [rootElementName]: result
+  };
+}
+function xmlObjectToString(xmlObject, options) {
+  const builder = new import_fast_xml_parser.XMLBuilder({
+    ...defaultBuilderOptions,
+    ...options
+  });
+  const xmlData = builder.build(xmlObject);
+  if (!xmlData) {
+    return "";
+  }
+  return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>${xmlData}`;
+}
+function serializeToXml(item, properties, rootName, rootNs, options, additionalPropertiesConfig) {
+  const xmlObject = serializeModelToXml(
+    item,
+    properties,
+    rootName,
+    rootNs,
+    additionalPropertiesConfig
+  );
+  return xmlObjectToString(xmlObject, options);
+}
+function parseXmlString(xmlString, options) {
+  const parser = new import_fast_xml_parser.XMLParser({
+    ...defaultParserOptions,
+    ...options
+  });
+  return parser.parse(xmlString);
+}
+function deserializePrimitiveValue(value, type, dateEncoding, bytesEncoding, primitiveSubtype) {
+  if (value === null || value === void 0) {
+    return void 0;
+  }
+  if (value === "" && primitiveSubtype !== "string") {
+    return void 0;
+  }
+  if (type === "date") {
+    if (dateEncoding === "unixTimestamp") {
+      return new Date(Number(value) * 1e3);
+    }
+    return new Date(value);
+  }
+  if (type === "bytes" && typeof value === "string") {
+    return (0, import_core_util.stringToUint8Array)(value, bytesEncoding ?? "base64");
+  }
+  if (primitiveSubtype === "boolean") {
+    return String(value).toLowerCase() === "true";
+  }
+  if (primitiveSubtype === "number") {
+    return Number(value);
+  }
+  return value;
+}
+function unwrapSingleElementArray(value) {
+  if (Array.isArray(value) && value.length === 1) {
+    return value[0];
+  }
+  return value;
+}
+function getElementValue(obj, xmlOptions) {
+  if (!obj) {
+    return void 0;
+  }
+  const { name, ns, attribute } = xmlOptions;
+  if (attribute) {
+    const attrName = ns?.prefix ? `@_${ns.prefix}:${name}` : `@_${name}`;
+    return obj[attrName];
+  }
+  const elementName = ns?.prefix ? `${ns.prefix}:${name}` : name;
+  const value = obj[elementName] ?? obj[name];
+  return unwrapSingleElementArray(value);
+}
+function deserializeArrayProperty(obj, metadata) {
+  const { xmlOptions, deserializer, type, dateEncoding } = metadata;
+  let arrayData;
+  if (xmlOptions.unwrapped) {
+    const itemName = getElementName(
+      xmlOptions.itemsName || xmlOptions.name,
+      xmlOptions.itemsNs || xmlOptions.ns
+    );
+    arrayData = obj[itemName] ?? obj[xmlOptions.itemsName || xmlOptions.name];
+  } else {
+    const wrapperName = getElementName(xmlOptions.name, xmlOptions.ns);
+    let wrapper = obj[wrapperName] ?? obj[xmlOptions.name];
+    if (!wrapper) {
+      return [];
+    }
+    wrapper = unwrapSingleElementArray(wrapper);
+    const itemName = getElementName(xmlOptions.itemsName || xmlOptions.name, xmlOptions.itemsNs);
+    arrayData = wrapper[itemName] ?? wrapper[xmlOptions.itemsName || xmlOptions.name] ?? wrapper;
+  }
+  if (!arrayData) {
+    return [];
+  }
+  const items = Array.isArray(arrayData) ? arrayData : [arrayData];
+  return items.map((item) => {
+    const unwrappedItem = unwrapSingleElementArray(item);
+    if (deserializer) {
+      return deserializer(unwrappedItem);
+    }
+    return deserializePrimitiveValue(
+      unwrappedItem,
+      metadata.itemType ?? type,
+      dateEncoding,
+      metadata.bytesEncoding,
+      metadata.primitiveSubtype
+    );
+  });
+}
+function deserializeXmlToModel(xmlObject, properties, rootName, rootNs, additionalPropertiesConfig) {
+  if (!xmlObject) {
+    return {};
+  }
+  const rootElementName = getElementName(rootName, rootNs);
+  let content = xmlObject[rootElementName] ?? xmlObject[rootName] ?? xmlObject;
+  content = unwrapSingleElementArray(content);
+  return deserializeXmlObject(content, properties, additionalPropertiesConfig);
+}
+function deserializeFromXml(xmlString, properties, rootName, rootNs, parserOptions, additionalPropertiesConfig) {
+  if (!xmlString) {
+    return {};
+  }
+  const xmlObject = parseXmlString(xmlString, parserOptions);
+  return deserializeXmlToModel(
+    xmlObject,
+    properties,
+    rootName,
+    rootNs,
+    additionalPropertiesConfig
+  );
+}
+function deserializeXmlObject(xmlObject, properties, additionalPropertiesConfig) {
+  if (!xmlObject) {
+    return {};
+  }
+  const content = unwrapSingleElementArray(xmlObject);
+  const result = {};
+  for (const prop of properties) {
+    const { propertyName, xmlOptions, deserializer, type, dateEncoding, primitiveSubtype } = prop;
+    if (type === "array" || xmlOptions.itemsName) {
+      result[propertyName] = deserializeArrayProperty(content, prop);
+    } else if (type === "dict") {
+      const rawValue = getElementValue(content, xmlOptions);
+      if (rawValue !== void 0 && typeof rawValue === "object") {
+        const dict = {};
+        for (const [key, val] of Object.entries(rawValue)) {
+          if (!key.startsWith("@_") && key !== "#text") {
+            dict[key] = String(val);
+          }
+        }
+        result[propertyName] = dict;
+      }
+    } else if (xmlOptions.unwrapped && type !== "object") {
+      const rawValue = content["#text"];
+      if (rawValue !== void 0) {
+        result[propertyName] = deserializePrimitiveValue(
+          rawValue,
+          type,
+          dateEncoding,
+          prop.bytesEncoding,
+          primitiveSubtype
+        );
+      }
+    } else {
+      const rawValue = getElementValue(content, xmlOptions);
+      if (rawValue === void 0) {
+        continue;
+      }
+      if (deserializer) {
+        if (typeof rawValue === "object") {
+          result[propertyName] = deserializer(rawValue);
+        } else {
+          result[propertyName] = deserializer({ "#text": rawValue });
+        }
+      } else {
+        result[propertyName] = deserializePrimitiveValue(
+          rawValue,
+          type,
+          dateEncoding,
+          prop.bytesEncoding,
+          primitiveSubtype
+        );
+      }
+    }
+  }
+  if (additionalPropertiesConfig) {
+    const { propertyName, excludeNames, deserializer: apDeserializer } = additionalPropertiesConfig;
+    const additionalProps = {};
+    const excludeSet = new Set(excludeNames);
+    for (const [key, val] of Object.entries(content)) {
+      if (key.startsWith("@_") || key === "#text" || excludeSet.has(key)) {
+        continue;
+      }
+      additionalProps[key] = apDeserializer ? apDeserializer(val) : String(val);
+    }
+    result[propertyName] = additionalProps;
+  }
+  return result;
+}
+function isXmlContentType(contentType) {
+  const normalized = contentType.toLowerCase();
+  return normalized.includes("application/xml") || normalized.includes("text/xml") || normalized.endsWith("+xml");
+}
+function isJsonContentType(contentType) {
+  const normalized = contentType.toLowerCase();
+  return normalized.includes("application/json") || normalized.includes("text/json") || normalized.endsWith("+json");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  deserializeFromXml,
+  deserializeXmlObject,
+  deserializeXmlToModel,
+  isJsonContentType,
+  isXmlContentType,
+  parseXmlString,
+  serializeModelToXml,
+  serializeToXml,
+  xmlObjectToString
+});
+//# sourceMappingURL=xml-helpers.js.map

package/dist/commonjs/generated/static-helpers/serialization/xml-helpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/generated/static-helpers/serialization/xml-helpers.ts"],
+  "sourcesContent": ["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { stringToUint8Array, uint8ArrayToString } from \"@azure/core-util\";\nimport { XMLBuilder, XMLParser, XmlBuilderOptions } from \"fast-xml-parser\";\n\n/**\n * XML serialization options for a property or model\n */\nexport interface XmlSerializationOptions {\n  /** Element or attribute name */\n  name: string;\n  /** If true, serialize as XML attribute instead of element */\n  attribute?: boolean;\n  /** XML namespace for this element/attribute */\n  ns?: {\n    namespace: string;\n    prefix: string;\n  };\n  /** For arrays - if true, items are inline without wrapper element */\n  unwrapped?: boolean;\n  /** For arrays - name of each item element */\n  itemsName?: string;\n  /** For arrays - namespace for item elements */\n  itemsNs?: {\n    namespace: string;\n    prefix: string;\n  };\n}\n\n/**\n * Metadata for serializing a model property to XML\n */\nexport interface XmlPropertyMetadata {\n  /** Client-side property name */\n  propertyName: string;\n  /** XML serialization options */\n  xmlOptions: XmlSerializationOptions;\n  /** Serializer function for complex types */\n  serializer?: (value: any) => XmlSerializedValue;\n  /** Type of the property for special handling */\n  type?: \"array\" | \"object\" | \"primitive\" | \"date\" | \"bytes\" | \"dict\";\n  /** Date encoding format */\n  dateEncoding?: \"rfc3339\" | \"rfc7231\" | \"unixTimestamp\";\n  /** Bytes encoding format (base64 or base64url) */\n  bytesEncoding?: \"base64\" | \"base64url\";\n  /** For arrays - type of each item for special handling */\n  itemType?: \"primitive\" | \"date\" | \"bytes\";\n}\n\n/**\n * Metadata for deserializing XML to a model property\n */\nexport interface XmlPropertyDeserializeMetadata {\n  /** Client-side property name */\n  propertyName: string;\n  /** XML serialization options */\n  xmlOptions: XmlSerializationOptions;\n  /** Deserializer function for complex types */\n  deserializer?: (value: any) => any;\n  /** Type of the property for special handling */\n  type?: \"array\" | \"object\" | \"primitive\" | \"date\" | \"bytes\" | \"dict\";\n  /** Subtype for primitive properties to drive type conversion from raw XML strings */\n  primitiveSubtype?: \"string\" | \"number\" | \"boolean\";\n  /** Date encoding format */\n  dateEncoding?: \"rfc3339\" | \"rfc7231\" | \"unixTimestamp\";\n  /** Bytes encoding format (base64 or base64url) */\n  bytesEncoding?: \"base64\" | \"base64url\";\n  /** For arrays - type of each item for special handling */\n  itemType?: \"primitive\" | \"date\" | \"bytes\";\n}\n\n/**\n * Configuration for collecting additional (undeclared) XML elements\n * into a Record property on the deserialized model.\n */\nexport interface XmlAdditionalPropertiesConfig {\n  /** Client-side property name to assign the collected record to */\n  propertyName: string;\n  /** XML element names of declared properties to exclude from collection */\n  excludeNames: string[];\n  /** Optional deserializer for complex value types */\n  deserializer?: (value: any) => any;\n}\n\n/**\n * Result of XML serialization - either a primitive value or structured XML object\n */\nexport type XmlSerializedValue = string | number | boolean | null | undefined | XmlSerializedObject;\n\nexport interface XmlSerializedObject {\n  [key: string]: XmlSerializedValue | XmlSerializedValue[];\n}\n\n// Default XML parser/builder options\nconst defaultParserOptions = {\n  ignoreAttributes: false,\n  attributeNamePrefix: \"@_\",\n  textNodeName: \"#text\",\n  parseTagValue: false,\n  parseAttributeValue: false,\n  trimValues: false, // Preserve whitespace in text content\n  isArray: (_name: string, _jpath: string | unknown, isLeafNode: boolean, isAttribute: boolean) => {\n    // Don't auto-detect arrays for attributes or leaf nodes by default\n    // Let the metadata drive array detection\n    return !isAttribute && !isLeafNode;\n  },\n};\n\nconst defaultBuilderOptions: Partial<XmlBuilderOptions> = {\n  ignoreAttributes: false,\n  attributeNamePrefix: \"@_\",\n  textNodeName: \"#text\",\n  format: false,\n  suppressEmptyNode: true,\n};\n\n/**\n * Creates an XML element name with optional namespace prefix\n */\nfunction getElementName(name: string, ns?: { namespace: string; prefix: string }): string {\n  if (ns?.prefix) {\n    return `${ns.prefix}:${name}`;\n  }\n  return name;\n}\n\n/**\n * Creates namespace declaration attributes for the root element\n */\nfunction createNamespaceDeclarations(namespaces: Map<string, string>): Record<string, string> {\n  const declarations: Record<string, string> = {};\n  for (const [prefix, namespace] of namespaces) {\n    if (prefix) {\n      declarations[`@_xmlns:${prefix}`] = namespace;\n    } else {\n      declarations[\"@_xmlns\"] = namespace;\n    }\n  }\n  return declarations;\n}\n\n/**\n * Collects all namespaces from property metadata\n */\nfunction collectNamespaces(\n  properties: XmlPropertyMetadata[],\n  rootNs?: { namespace: string; prefix: string },\n): Map<string, string> {\n  const namespaces = new Map<string, string>();\n\n  if (rootNs) {\n    namespaces.set(rootNs.prefix, rootNs.namespace);\n  }\n\n  for (const prop of properties) {\n    if (prop.xmlOptions.ns) {\n      namespaces.set(prop.xmlOptions.ns.prefix, prop.xmlOptions.ns.namespace);\n    }\n    if (prop.xmlOptions.itemsNs) {\n      namespaces.set(prop.xmlOptions.itemsNs.prefix, prop.xmlOptions.itemsNs.namespace);\n    }\n  }\n\n  return namespaces;\n}\n\n/**\n * Serializes a primitive value for XML\n */\nfunction serializePrimitiveValue(\n  value: any,\n  type?: \"array\" | \"object\" | \"primitive\" | \"date\" | \"bytes\" | \"dict\",\n  dateEncoding?: \"rfc3339\" | \"rfc7231\" | \"unixTimestamp\",\n  bytesEncoding?: \"base64\" | \"base64url\",\n): string | number | boolean {\n  if (value === null || value === undefined) {\n    return \"\";\n  }\n\n  if (type === \"date\" && value instanceof Date) {\n    switch (dateEncoding) {\n      case \"rfc7231\":\n        return value.toUTCString();\n      case \"unixTimestamp\":\n        return Math.floor(value.getTime() / 1000);\n      case \"rfc3339\":\n      default:\n        return value.toISOString();\n    }\n  }\n\n  if (type === \"bytes\" && value instanceof Uint8Array) {\n    return uint8ArrayToString(value, bytesEncoding ?? \"base64\");\n  }\n\n  if (typeof value === \"boolean\" || typeof value === \"number\") {\n    return value;\n  }\n\n  return String(value);\n}\n\n/**\n * Serializes an array property to XML format\n */\nfunction serializeArrayProperty(\n  value: any[],\n  metadata: XmlPropertyMetadata,\n): XmlSerializedObject | XmlSerializedValue[] {\n  const { xmlOptions, serializer } = metadata;\n  const itemName = getElementName(\n    xmlOptions.itemsName || xmlOptions.name,\n    xmlOptions.itemsNs || xmlOptions.ns,\n  );\n\n  const serializedItems = value.map((item) => {\n    if (serializer) {\n      return serializer(item);\n    }\n    return serializePrimitiveValue(\n      item,\n      metadata.itemType ?? metadata.type,\n      metadata.dateEncoding,\n      metadata.bytesEncoding,\n    );\n  });\n\n  if (xmlOptions.unwrapped) {\n    // Unwrapped: return items directly (they'll be siblings)\n    return serializedItems;\n  } else {\n    // Wrapped: items are nested under a wrapper element, which contains item elements\n    const wrapperName = getElementName(xmlOptions.name, xmlOptions.ns);\n    return {\n      [wrapperName]: {\n        [itemName]: serializedItems,\n      },\n    } as XmlSerializedObject;\n  }\n}\n\n/**\n * Serializes a model to XML object structure\n */\nexport function serializeModelToXml(\n  item: Record<string, any>,\n  properties: XmlPropertyMetadata[],\n  rootName: string,\n  rootNs?: { namespace: string; prefix: string },\n  additionalPropertiesConfig?: XmlAdditionalPropertiesConfig,\n): XmlSerializedObject {\n  if (item === null || item === undefined) {\n    return {};\n  }\n\n  const result: XmlSerializedObject = {};\n  const attributes: Record<string, any> = {};\n\n  // Collect and add namespace declarations\n  const namespaces = collectNamespaces(properties, rootNs);\n  const nsDeclarations = createNamespaceDeclarations(namespaces);\n  Object.assign(attributes, nsDeclarations);\n\n  for (const prop of properties) {\n    const value = item[prop.propertyName];\n\n    if (value === undefined) {\n      continue;\n    }\n\n    const { xmlOptions, serializer, type } = prop;\n    const elementName = getElementName(xmlOptions.name, xmlOptions.ns);\n\n    if (xmlOptions.attribute) {\n      // Serialize as attribute\n      const attrName = xmlOptions.ns?.prefix\n        ? `@_${xmlOptions.ns.prefix}:${xmlOptions.name}`\n        : `@_${xmlOptions.name}`;\n      attributes[attrName] = serializePrimitiveValue(\n        value,\n        type,\n        prop.dateEncoding,\n        prop.bytesEncoding,\n      );\n    } else if (type === \"dict\" && value !== null && typeof value === \"object\") {\n      // Serialize dictionary - each key-value pair becomes an element\n      const dictContent: Record<string, XmlSerializedValue> = {};\n      for (const [key, val] of Object.entries(value)) {\n        dictContent[key] = String(val);\n      }\n      result[elementName] = dictContent;\n    } else if (Array.isArray(value)) {\n      // Serialize array\n      const arrayResult = serializeArrayProperty(value, prop);\n      if (xmlOptions.unwrapped && Array.isArray(arrayResult)) {\n        // For unwrapped arrays, add each item as a separate element\n        const itemName = getElementName(\n          xmlOptions.itemsName || xmlOptions.name,\n          xmlOptions.itemsNs || xmlOptions.ns,\n        );\n        result[itemName] = arrayResult as XmlSerializedValue[];\n      } else {\n        Object.assign(result, arrayResult);\n      }\n    } else if (value !== null && typeof value === \"object\" && serializer) {\n      // Serialize nested object\n      result[elementName] = serializer(value);\n    } else if (xmlOptions.unwrapped && !Array.isArray(value)) {\n      // Unwrapped primitive - this becomes the text content of the parent element\n      result[\"#text\"] = serializePrimitiveValue(value, type, prop.dateEncoding, prop.bytesEncoding);\n    } else {\n      // Serialize primitive\n      result[elementName] = serializePrimitiveValue(\n        value,\n        type,\n        prop.dateEncoding,\n        prop.bytesEncoding,\n      );\n    }\n  }\n\n  // Serialize additionalProperties entries as sibling XML elements\n  if (additionalPropertiesConfig) {\n    const apValue = item[additionalPropertiesConfig.propertyName];\n    if (apValue && typeof apValue === \"object\") {\n      for (const [key, val] of Object.entries(apValue)) {\n        result[key] = additionalPropertiesConfig.deserializer\n          ? additionalPropertiesConfig.deserializer(val)\n          : String(val);\n      }\n    }\n  }\n\n  // Merge attributes into result\n  Object.assign(result, attributes);\n\n  // Wrap in root element\n  const rootElementName = getElementName(rootName, rootNs);\n  return {\n    [rootElementName]: result,\n  };\n}\n\n/**\n * Converts an XML object structure to XML string\n */\nexport function xmlObjectToString(\n  xmlObject: XmlSerializedObject,\n  options?: Partial<XmlBuilderOptions>,\n): string {\n  const builder = new XMLBuilder({\n    ...defaultBuilderOptions,\n    ...options,\n  });\n\n  const xmlData: string = builder.build(xmlObject);\n  if (!xmlData) {\n    return \"\";\n  }\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>${xmlData}`;\n}\n\n/**\n * Full serialization: model to XML string\n */\nexport function serializeToXml(\n  item: Record<string, any>,\n  properties: XmlPropertyMetadata[],\n  rootName: string,\n  rootNs?: { namespace: string; prefix: string },\n  options?: Partial<XmlBuilderOptions>,\n  additionalPropertiesConfig?: XmlAdditionalPropertiesConfig,\n): string {\n  const xmlObject = serializeModelToXml(\n    item,\n    properties,\n    rootName,\n    rootNs,\n    additionalPropertiesConfig,\n  );\n  return xmlObjectToString(xmlObject, options);\n}\n\n/**\n * Parses XML string to object structure\n */\nexport function parseXmlString(\n  xmlString: string,\n  options?: Partial<typeof defaultParserOptions>,\n): any {\n  const parser = new XMLParser({\n    ...defaultParserOptions,\n    ...options,\n  });\n\n  return parser.parse(xmlString);\n}\n\n/**\n * Deserializes a primitive value from XML\n */\nfunction deserializePrimitiveValue(\n  value: any,\n  type?: \"array\" | \"object\" | \"primitive\" | \"date\" | \"bytes\" | \"dict\",\n  dateEncoding?: \"rfc3339\" | \"rfc7231\" | \"unixTimestamp\",\n  bytesEncoding?: \"base64\" | \"base64url\",\n  primitiveSubtype?: \"string\" | \"number\" | \"boolean\",\n): any {\n  if (value === null || value === undefined) {\n    return undefined;\n  }\n\n  if (value === \"\" && primitiveSubtype !== \"string\") {\n    return undefined;\n  }\n\n  if (type === \"date\") {\n    if (dateEncoding === \"unixTimestamp\") {\n      return new Date(Number(value) * 1000);\n    }\n    return new Date(value);\n  }\n\n  if (type === \"bytes\" && typeof value === \"string\") {\n    return stringToUint8Array(value, bytesEncoding ?? \"base64\");\n  }\n\n  // Convert raw XML string to the expected JS type\n  if (primitiveSubtype === \"boolean\") {\n    return String(value).toLowerCase() === \"true\";\n  }\n  if (primitiveSubtype === \"number\") {\n    return Number(value);\n  }\n\n  return value;\n}\n\n/**\n * Unwraps a value if it's a single-element array (parser wraps non-leaf elements in arrays)\n */\nfunction unwrapSingleElementArray(value: any): any {\n  if (Array.isArray(value) && value.length === 1) {\n    return value[0];\n  }\n  return value;\n}\n\n/**\n * Extracts element value from parsed XML, handling namespaces\n */\nfunction getElementValue(obj: any, xmlOptions: XmlSerializationOptions): any {\n  if (!obj) {\n    return undefined;\n  }\n\n  const { name, ns, attribute } = xmlOptions;\n\n  if (attribute) {\n    // Look for attribute with or without namespace prefix\n    const attrName = ns?.prefix ? `@_${ns.prefix}:${name}` : `@_${name}`;\n    return obj[attrName];\n  }\n\n  // Look for element with or without namespace prefix\n  const elementName = ns?.prefix ? `${ns.prefix}:${name}` : name;\n  const value = obj[elementName] ?? obj[name]; // Fall back to name without prefix\n\n  // Unwrap single-element arrays (parser wraps non-leaf elements in arrays)\n  return unwrapSingleElementArray(value);\n}\n\n/**\n * Deserializes an array from XML\n */\nfunction deserializeArrayProperty(obj: any, metadata: XmlPropertyDeserializeMetadata): any[] {\n  const { xmlOptions, deserializer, type, dateEncoding } = metadata;\n\n  let arrayData: any;\n\n  if (xmlOptions.unwrapped) {\n    // Items are direct children\n    const itemName = getElementName(\n      xmlOptions.itemsName || xmlOptions.name,\n      xmlOptions.itemsNs || xmlOptions.ns,\n    );\n    arrayData = obj[itemName] ?? obj[xmlOptions.itemsName || xmlOptions.name];\n  } else {\n    // Items are nested under wrapper element\n    const wrapperName = getElementName(xmlOptions.name, xmlOptions.ns);\n    let wrapper = obj[wrapperName] ?? obj[xmlOptions.name];\n\n    if (!wrapper) {\n      return [];\n    }\n\n    // Unwrap single-element array if the parser wrapped it\n    wrapper = unwrapSingleElementArray(wrapper);\n\n    const itemName = getElementName(xmlOptions.itemsName || xmlOptions.name, xmlOptions.itemsNs);\n    arrayData = wrapper[itemName] ?? wrapper[xmlOptions.itemsName || xmlOptions.name] ?? wrapper;\n  }\n\n  if (!arrayData) {\n    return [];\n  }\n\n  // Ensure it's an array\n  const items = Array.isArray(arrayData) ? arrayData : [arrayData];\n\n  return items.map((item) => {\n    // Unwrap single-element array for each item if needed\n    const unwrappedItem = unwrapSingleElementArray(item);\n    if (deserializer) {\n      return deserializer(unwrappedItem);\n    }\n    return deserializePrimitiveValue(\n      unwrappedItem,\n      metadata.itemType ?? type,\n      dateEncoding,\n      metadata.bytesEncoding,\n      metadata.primitiveSubtype,\n    );\n  });\n}\n\n/**\n * Deserializes XML object structure to model\n */\nexport function deserializeXmlToModel<T = Record<string, any>>(\n  xmlObject: any,\n  properties: XmlPropertyDeserializeMetadata[],\n  rootName: string,\n  rootNs?: { namespace: string; prefix: string },\n  additionalPropertiesConfig?: XmlAdditionalPropertiesConfig,\n): T {\n  if (!xmlObject) {\n    return {} as T;\n  }\n\n  // Get root element content - unwrap if it's wrapped in an array by the parser\n  const rootElementName = getElementName(rootName, rootNs);\n  let content = xmlObject[rootElementName] ?? xmlObject[rootName] ?? xmlObject;\n  content = unwrapSingleElementArray(content);\n\n  return deserializeXmlObject<T>(content, properties, additionalPropertiesConfig);\n}\n\n/**\n * Full deserialization: XML string to model\n */\nexport function deserializeFromXml<T = Record<string, any>>(\n  xmlString: string | undefined,\n  properties: XmlPropertyDeserializeMetadata[],\n  rootName: string,\n  rootNs?: { namespace: string; prefix: string },\n  parserOptions?: Partial<typeof defaultParserOptions>,\n  additionalPropertiesConfig?: XmlAdditionalPropertiesConfig,\n): T {\n  if (!xmlString) {\n    return {} as T;\n  }\n  const xmlObject = parseXmlString(xmlString, parserOptions);\n  return deserializeXmlToModel<T>(\n    xmlObject,\n    properties,\n    rootName,\n    rootNs,\n    additionalPropertiesConfig,\n  );\n}\n\n/**\n * Deserializes a pre-parsed XML object to a model.\n * This is used for nested objects where the XML has already been parsed\n * and we have the object content directly (without a root element wrapper).\n * Unlike deserializeFromXml, this does not parse XML strings and does not\n * expect a root element to unwrap.\n */\nexport function deserializeXmlObject<T = Record<string, any>>(\n  xmlObject: Record<string, unknown>,\n  properties: XmlPropertyDeserializeMetadata[],\n  additionalPropertiesConfig?: XmlAdditionalPropertiesConfig,\n): T {\n  if (!xmlObject) {\n    return {} as T;\n  }\n\n  // Unwrap if parser wrapped in single-element array\n  const content = unwrapSingleElementArray(xmlObject);\n\n  const result: Record<string, any> = {};\n\n  for (const prop of properties) {\n    const { propertyName, xmlOptions, deserializer, type, dateEncoding, primitiveSubtype } = prop;\n\n    if (type === \"array\" || xmlOptions.itemsName) {\n      // Deserialize array\n      result[propertyName] = deserializeArrayProperty(content, prop);\n    } else if (type === \"dict\") {\n      // Deserialize dictionary - each child element is a key-value pair\n      const rawValue = getElementValue(content, xmlOptions);\n      if (rawValue !== undefined && typeof rawValue === \"object\") {\n        const dict: Record<string, string> = {};\n        for (const [key, val] of Object.entries(rawValue)) {\n          // Skip attributes (start with @_) and text nodes (#text)\n          if (!key.startsWith(\"@_\") && key !== \"#text\") {\n            dict[key] = String(val);\n          }\n        }\n        result[propertyName] = dict;\n      }\n    } else if (xmlOptions.unwrapped && type !== \"object\") {\n      // Unwrapped primitive - get text content from the element\n      const rawValue = content[\"#text\"];\n      if (rawValue !== undefined) {\n        result[propertyName] = deserializePrimitiveValue(\n          rawValue,\n          type,\n          dateEncoding,\n          prop.bytesEncoding,\n          primitiveSubtype,\n        );\n      }\n    } else {\n      // Get element or attribute value\n      const rawValue = getElementValue(content, xmlOptions);\n\n      if (rawValue === undefined) {\n        continue;\n      }\n\n      if (deserializer) {\n        // Deserialize nested object\n        if (typeof rawValue === \"object\") {\n          result[propertyName] = deserializer(rawValue);\n        } else {\n          // When the XML element only contains text content (like <Name>text</Name>),\n          // the parser returns the text as a string. Wrap it in an object with #text\n          // so the nested deserializer can extract unwrapped text content properly.\n          result[propertyName] = deserializer({ \"#text\": rawValue });\n        }\n      } else {\n        // Deserialize primitive\n        result[propertyName] = deserializePrimitiveValue(\n          rawValue,\n          type,\n          dateEncoding,\n          prop.bytesEncoding,\n          primitiveSubtype,\n        );\n      }\n    }\n  }\n\n  // Collect undeclared XML elements into additionalProperties\n  if (additionalPropertiesConfig) {\n    const { propertyName, excludeNames, deserializer: apDeserializer } = additionalPropertiesConfig;\n    const additionalProps: Record<string, any> = {};\n    const excludeSet = new Set(excludeNames);\n    for (const [key, val] of Object.entries(content)) {\n      if (key.startsWith(\"@_\") || key === \"#text\" || excludeSet.has(key)) {\n        continue;\n      }\n      additionalProps[key] = apDeserializer ? apDeserializer(val) : String(val);\n    }\n    result[propertyName] = additionalProps;\n  }\n\n  return result as T;\n}\n\n/**\n * Utility to check if a content type is XML\n */\nexport function isXmlContentType(contentType: string): boolean {\n  const normalized = contentType.toLowerCase();\n  return (\n    normalized.includes(\"application/xml\") ||\n    normalized.includes(\"text/xml\") ||\n    normalized.endsWith(\"+xml\")\n  );\n}\n\n/**\n * Utility to check if a content type is JSON\n */\nexport function isJsonContentType(contentType: string): boolean {\n  const normalized = contentType.toLowerCase();\n  return (\n    normalized.includes(\"application/json\") ||\n    normalized.includes(\"text/json\") ||\n    normalized.endsWith(\"+json\")\n  );\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,uBAAuD;AACvD,6BAAyD;AA2FzD,MAAM,uBAAuB;AAAA,EAC3B,kBAAkB;AAAA,EAClB,qBAAqB;AAAA,EACrB,cAAc;AAAA,EACd,eAAe;AAAA,EACf,qBAAqB;AAAA,EACrB,YAAY;AAAA;AAAA,EACZ,SAAS,CAAC,OAAe,QAA0B,YAAqB,gBAAyB;AAG/F,WAAO,CAAC,eAAe,CAAC;AAAA,EAC1B;AACF;AAEA,MAAM,wBAAoD;AAAA,EACxD,kBAAkB;AAAA,EAClB,qBAAqB;AAAA,EACrB,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,mBAAmB;AACrB;AAKA,SAAS,eAAe,MAAc,IAAoD;AACxF,MAAI,IAAI,QAAQ;AACd,WAAO,GAAG,GAAG,MAAM,IAAI,IAAI;AAAA,EAC7B;AACA,SAAO;AACT;AAKA,SAAS,4BAA4B,YAAyD;AAC5F,QAAM,eAAuC,CAAC;AAC9C,aAAW,CAAC,QAAQ,SAAS,KAAK,YAAY;AAC5C,QAAI,QAAQ;AACV,mBAAa,WAAW,MAAM,EAAE,IAAI;AAAA,IACtC,OAAO;AACL,mBAAa,SAAS,IAAI;AAAA,IAC5B;AAAA,EACF;AACA,SAAO;AACT;AAKA,SAAS,kBACP,YACA,QACqB;AACrB,QAAM,aAAa,oBAAI,IAAoB;AAE3C,MAAI,QAAQ;AACV,eAAW,IAAI,OAAO,QAAQ,OAAO,SAAS;AAAA,EAChD;AAEA,aAAW,QAAQ,YAAY;AAC7B,QAAI,KAAK,WAAW,IAAI;AACtB,iBAAW,IAAI,KAAK,WAAW,GAAG,QAAQ,KAAK,WAAW,GAAG,SAAS;AAAA,IACxE;AACA,QAAI,KAAK,WAAW,SAAS;AAC3B,iBAAW,IAAI,KAAK,WAAW,QAAQ,QAAQ,KAAK,WAAW,QAAQ,SAAS;AAAA,IAClF;AAAA,EACF;AAEA,SAAO;AACT;AAKA,SAAS,wBACP,OACA,MACA,cACA,eAC2B;AAC3B,MAAI,UAAU,QAAQ,UAAU,QAAW;AACzC,WAAO;AAAA,EACT;AAEA,MAAI,SAAS,UAAU,iBAAiB,MAAM;AAC5C,YAAQ,cAAc;AAAA,MACpB,KAAK;AACH,eAAO,MAAM,YAAY;AAAA,MAC3B,KAAK;AACH,eAAO,KAAK,MAAM,MAAM,QAAQ,IAAI,GAAI;AAAA,MAC1C,KAAK;AAAA,MACL;AACE,eAAO,MAAM,YAAY;AAAA,IAC7B;AAAA,EACF;AAEA,MAAI,SAAS,WAAW,iBAAiB,YAAY;AACnD,eAAO,qCAAmB,OAAO,iBAAiB,QAAQ;AAAA,EAC5D;AAEA,MAAI,OAAO,UAAU,aAAa,OAAO,UAAU,UAAU;AAC3D,WAAO;AAAA,EACT;AAEA,SAAO,OAAO,KAAK;AACrB;AAKA,SAAS,uBACP,OACA,UAC4C;AAC5C,QAAM,EAAE,YAAY,WAAW,IAAI;AACnC,QAAM,WAAW;AAAA,IACf,WAAW,aAAa,WAAW;AAAA,IACnC,WAAW,WAAW,WAAW;AAAA,EACnC;AAEA,QAAM,kBAAkB,MAAM,IAAI,CAAC,SAAS;AAC1C,QAAI,YAAY;AACd,aAAO,WAAW,IAAI;AAAA,IACxB;AACA,WAAO;AAAA,MACL;AAAA,MACA,SAAS,YAAY,SAAS;AAAA,MAC9B,SAAS;AAAA,MACT,SAAS;AAAA,IACX;AAAA,EACF,CAAC;AAED,MAAI,WAAW,WAAW;AAExB,WAAO;AAAA,EACT,OAAO;AAEL,UAAM,cAAc,eAAe,WAAW,MAAM,WAAW,EAAE;AACjE,WAAO;AAAA,MACL,CAAC,WAAW,GAAG;AAAA,QACb,CAAC,QAAQ,GAAG;AAAA,MACd;AAAA,IACF;AAAA,EACF;AACF;AAKO,SAAS,oBACd,MACA,YACA,UACA,QACA,4BACqB;AACrB,MAAI,SAAS,QAAQ,SAAS,QAAW;AACvC,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,SAA8B,CAAC;AACrC,QAAM,aAAkC,CAAC;AAGzC,QAAM,aAAa,kBAAkB,YAAY,MAAM;AACvD,QAAM,iBAAiB,4BAA4B,UAAU;AAC7D,SAAO,OAAO,YAAY,cAAc;AAExC,aAAW,QAAQ,YAAY;AAC7B,UAAM,QAAQ,KAAK,KAAK,YAAY;AAEpC,QAAI,UAAU,QAAW;AACvB;AAAA,IACF;AAEA,UAAM,EAAE,YAAY,YAAY,KAAK,IAAI;AACzC,UAAM,cAAc,eAAe,WAAW,MAAM,WAAW,EAAE;AAEjE,QAAI,WAAW,WAAW;AAExB,YAAM,WAAW,WAAW,IAAI,SAC5B,KAAK,WAAW,GAAG,MAAM,IAAI,WAAW,IAAI,KAC5C,KAAK,WAAW,IAAI;AACxB,iBAAW,QAAQ,IAAI;AAAA,QACrB;AAAA,QACA;AAAA,QACA,KAAK;AAAA,QACL,KAAK;AAAA,MACP;AAAA,IACF,WAAW,SAAS,UAAU,UAAU,QAAQ,OAAO,UAAU,UAAU;AAEzE,YAAM,cAAkD,CAAC;AACzD,iBAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC9C,oBAAY,GAAG,IAAI,OAAO,GAAG;AAAA,MAC/B;AACA,aAAO,WAAW,IAAI;AAAA,IACxB,WAAW,MAAM,QAAQ,KAAK,GAAG;AAE/B,YAAM,cAAc,uBAAuB,OAAO,IAAI;AACtD,UAAI,WAAW,aAAa,MAAM,QAAQ,WAAW,GAAG;AAEtD,cAAM,WAAW;AAAA,UACf,WAAW,aAAa,WAAW;AAAA,UACnC,WAAW,WAAW,WAAW;AAAA,QACnC;AACA,eAAO,QAAQ,IAAI;AAAA,MACrB,OAAO;AACL,eAAO,OAAO,QAAQ,WAAW;AAAA,MACnC;AAAA,IACF,WAAW,UAAU,QAAQ,OAAO,UAAU,YAAY,YAAY;AAEpE,aAAO,WAAW,IAAI,WAAW,KAAK;AAAA,IACxC,WAAW,WAAW,aAAa,CAAC,MAAM,QAAQ,KAAK,GAAG;AAExD,aAAO,OAAO,IAAI,wBAAwB,OAAO,MAAM,KAAK,cAAc,KAAK,aAAa;AAAA,IAC9F,OAAO;AAEL,aAAO,WAAW,IAAI;AAAA,QACpB;AAAA,QACA;AAAA,QACA,KAAK;AAAA,QACL,KAAK;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAGA,MAAI,4BAA4B;AAC9B,UAAM,UAAU,KAAK,2BAA2B,YAAY;AAC5D,QAAI,WAAW,OAAO,YAAY,UAAU;AAC1C,iBAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,OAAO,GAAG;AAChD,eAAO,GAAG,IAAI,2BAA2B,eACrC,2BAA2B,aAAa,GAAG,IAC3C,OAAO,GAAG;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AAGA,SAAO,OAAO,QAAQ,UAAU;AAGhC,QAAM,kBAAkB,eAAe,UAAU,MAAM;AACvD,SAAO;AAAA,IACL,CAAC,eAAe,GAAG;AAAA,EACrB;AACF;AAKO,SAAS,kBACd,WACA,SACQ;AACR,QAAM,UAAU,IAAI,kCAAW;AAAA,IAC7B,GAAG;AAAA,IACH,GAAG;AAAA,EACL,CAAC;AAED,QAAM,UAAkB,QAAQ,MAAM,SAAS;AAC/C,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AACA,SAAO,0DAA0D,OAAO;AAC1E;AAKO,SAAS,eACd,MACA,YACA,UACA,QACA,SACA,4BACQ;AACR,QAAM,YAAY;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,SAAO,kBAAkB,WAAW,OAAO;AAC7C;AAKO,SAAS,eACd,WACA,SACK;AACL,QAAM,SAAS,IAAI,iCAAU;AAAA,IAC3B,GAAG;AAAA,IACH,GAAG;AAAA,EACL,CAAC;AAED,SAAO,OAAO,MAAM,SAAS;AAC/B;AAKA,SAAS,0BACP,OACA,MACA,cACA,eACA,kBACK;AACL,MAAI,UAAU,QAAQ,UAAU,QAAW;AACzC,WAAO;AAAA,EACT;AAEA,MAAI,UAAU,MAAM,qBAAqB,UAAU;AACjD,WAAO;AAAA,EACT;AAEA,MAAI,SAAS,QAAQ;AACnB,QAAI,iBAAiB,iBAAiB;AACpC,aAAO,IAAI,KAAK,OAAO,KAAK,IAAI,GAAI;AAAA,IACtC;AACA,WAAO,IAAI,KAAK,KAAK;AAAA,EACvB;AAEA,MAAI,SAAS,WAAW,OAAO,UAAU,UAAU;AACjD,eAAO,qCAAmB,OAAO,iBAAiB,QAAQ;AAAA,EAC5D;AAGA,MAAI,qBAAqB,WAAW;AAClC,WAAO,OAAO,KAAK,EAAE,YAAY,MAAM;AAAA,EACzC;AACA,MAAI,qBAAqB,UAAU;AACjC,WAAO,OAAO,KAAK;AAAA,EACrB;AAEA,SAAO;AACT;AAKA,SAAS,yBAAyB,OAAiB;AACjD,MAAI,MAAM,QAAQ,KAAK,KAAK,MAAM,WAAW,GAAG;AAC9C,WAAO,MAAM,CAAC;AAAA,EAChB;AACA,SAAO;AACT;AAKA,SAAS,gBAAgB,KAAU,YAA0C;AAC3E,MAAI,CAAC,KAAK;AACR,WAAO;AAAA,EACT;AAEA,QAAM,EAAE,MAAM,IAAI,UAAU,IAAI;AAEhC,MAAI,WAAW;AAEb,UAAM,WAAW,IAAI,SAAS,KAAK,GAAG,MAAM,IAAI,IAAI,KAAK,KAAK,IAAI;AAClE,WAAO,IAAI,QAAQ;AAAA,EACrB;AAGA,QAAM,cAAc,IAAI,SAAS,GAAG,GAAG,MAAM,IAAI,IAAI,KAAK;AAC1D,QAAM,QAAQ,IAAI,WAAW,KAAK,IAAI,IAAI;AAG1C,SAAO,yBAAyB,KAAK;AACvC;AAKA,SAAS,yBAAyB,KAAU,UAAiD;AAC3F,QAAM,EAAE,YAAY,cAAc,MAAM,aAAa,IAAI;AAEzD,MAAI;AAEJ,MAAI,WAAW,WAAW;AAExB,UAAM,WAAW;AAAA,MACf,WAAW,aAAa,WAAW;AAAA,MACnC,WAAW,WAAW,WAAW;AAAA,IACnC;AACA,gBAAY,IAAI,QAAQ,KAAK,IAAI,WAAW,aAAa,WAAW,IAAI;AAAA,EAC1E,OAAO;AAEL,UAAM,cAAc,eAAe,WAAW,MAAM,WAAW,EAAE;AACjE,QAAI,UAAU,IAAI,WAAW,KAAK,IAAI,WAAW,IAAI;AAErD,QAAI,CAAC,SAAS;AACZ,aAAO,CAAC;AAAA,IACV;AAGA,cAAU,yBAAyB,OAAO;AAE1C,UAAM,WAAW,eAAe,WAAW,aAAa,WAAW,MAAM,WAAW,OAAO;AAC3F,gBAAY,QAAQ,QAAQ,KAAK,QAAQ,WAAW,aAAa,WAAW,IAAI,KAAK;AAAA,EACvF;AAEA,MAAI,CAAC,WAAW;AACd,WAAO,CAAC;AAAA,EACV;AAGA,QAAM,QAAQ,MAAM,QAAQ,SAAS,IAAI,YAAY,CAAC,SAAS;AAE/D,SAAO,MAAM,IAAI,CAAC,SAAS;AAEzB,UAAM,gBAAgB,yBAAyB,IAAI;AACnD,QAAI,cAAc;AAChB,aAAO,aAAa,aAAa;AAAA,IACnC;AACA,WAAO;AAAA,MACL;AAAA,MACA,SAAS,YAAY;AAAA,MACrB;AAAA,MACA,SAAS;AAAA,MACT,SAAS;AAAA,IACX;AAAA,EACF,CAAC;AACH;AAKO,SAAS,sBACd,WACA,YACA,UACA,QACA,4BACG;AACH,MAAI,CAAC,WAAW;AACd,WAAO,CAAC;AAAA,EACV;AAGA,QAAM,kBAAkB,eAAe,UAAU,MAAM;AACvD,MAAI,UAAU,UAAU,eAAe,KAAK,UAAU,QAAQ,KAAK;AACnE,YAAU,yBAAyB,OAAO;AAE1C,SAAO,qBAAwB,SAAS,YAAY,0BAA0B;AAChF;AAKO,SAAS,mBACd,WACA,YACA,UACA,QACA,eACA,4BACG;AACH,MAAI,CAAC,WAAW;AACd,WAAO,CAAC;AAAA,EACV;AACA,QAAM,YAAY,eAAe,WAAW,aAAa;AACzD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AASO,SAAS,qBACd,WACA,YACA,4BACG;AACH,MAAI,CAAC,WAAW;AACd,WAAO,CAAC;AAAA,EACV;AAGA,QAAM,UAAU,yBAAyB,SAAS;AAElD,QAAM,SAA8B,CAAC;AAErC,aAAW,QAAQ,YAAY;AAC7B,UAAM,EAAE,cAAc,YAAY,cAAc,MAAM,cAAc,iBAAiB,IAAI;AAEzF,QAAI,SAAS,WAAW,WAAW,WAAW;AAE5C,aAAO,YAAY,IAAI,yBAAyB,SAAS,IAAI;AAAA,IAC/D,WAAW,SAAS,QAAQ;AAE1B,YAAM,WAAW,gBAAgB,SAAS,UAAU;AACpD,UAAI,aAAa,UAAa,OAAO,aAAa,UAAU;AAC1D,cAAM,OAA+B,CAAC;AACtC,mBAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,QAAQ,GAAG;AAEjD,cAAI,CAAC,IAAI,WAAW,IAAI,KAAK,QAAQ,SAAS;AAC5C,iBAAK,GAAG,IAAI,OAAO,GAAG;AAAA,UACxB;AAAA,QACF;AACA,eAAO,YAAY,IAAI;AAAA,MACzB;AAAA,IACF,WAAW,WAAW,aAAa,SAAS,UAAU;AAEpD,YAAM,WAAW,QAAQ,OAAO;AAChC,UAAI,aAAa,QAAW;AAC1B,eAAO,YAAY,IAAI;AAAA,UACrB;AAAA,UACA;AAAA,UACA;AAAA,UACA,KAAK;AAAA,UACL;AAAA,QACF;AAAA,MACF;AAAA,IACF,OAAO;AAEL,YAAM,WAAW,gBAAgB,SAAS,UAAU;AAEpD,UAAI,aAAa,QAAW;AAC1B;AAAA,MACF;AAEA,UAAI,cAAc;AAEhB,YAAI,OAAO,aAAa,UAAU;AAChC,iBAAO,YAAY,IAAI,aAAa,QAAQ;AAAA,QAC9C,OAAO;AAIL,iBAAO,YAAY,IAAI,aAAa,EAAE,SAAS,SAAS,CAAC;AAAA,QAC3D;AAAA,MACF,OAAO;AAEL,eAAO,YAAY,IAAI;AAAA,UACrB;AAAA,UACA;AAAA,UACA;AAAA,UACA,KAAK;AAAA,UACL;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAGA,MAAI,4BAA4B;AAC9B,UAAM,EAAE,cAAc,cAAc,cAAc,eAAe,IAAI;AACrE,UAAM,kBAAuC,CAAC;AAC9C,UAAM,aAAa,IAAI,IAAI,YAAY;AACvC,eAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,OAAO,GAAG;AAChD,UAAI,IAAI,WAAW,IAAI,KAAK,QAAQ,WAAW,WAAW,IAAI,GAAG,GAAG;AAClE;AAAA,MACF;AACA,sBAAgB,GAAG,IAAI,iBAAiB,eAAe,GAAG,IAAI,OAAO,GAAG;AAAA,IAC1E;AACA,WAAO,YAAY,IAAI;AAAA,EACzB;AAEA,SAAO;AACT;AAKO,SAAS,iBAAiB,aAA8B;AAC7D,QAAM,aAAa,YAAY,YAAY;AAC3C,SACE,WAAW,SAAS,iBAAiB,KACrC,WAAW,SAAS,UAAU,KAC9B,WAAW,SAAS,MAAM;AAE9B;AAKO,SAAS,kBAAkB,aAA8B;AAC9D,QAAM,aAAa,YAAY,YAAY;AAC3C,SACE,WAAW,SAAS,kBAAkB,KACtC,WAAW,SAAS,WAAW,KAC/B,WAAW,SAAS,OAAO;AAE/B;",
+  "names": []
+}