@ixo/editor 6.32.1 → 6.34.0

package/dist/chunk-N3ORMGAI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/lib/actionRegistry/manifestV2.schema.ts","../src/core/lib/actionRegistry/manifestV2.ts"],"sourcesContent":["/** JSON Schema 2020-12 for the signed Manifest v2 envelope. */\nexport const ACTION_MANIFEST_V2_SCHEMA = {\n  $schema: 'https://json-schema.org/draft/2020-12/schema',\n  $id: 'https://ixo.world/schemas/qi/action-manifest-v2.schema.json',\n  type: 'object',\n  additionalProperties: false,\n  required: ['manifestVersion', 'manifestId', 'generatedAt', 'package', 'issuer', 'compatibility', 'actions', 'primitives', 'integrity'],\n  properties: {\n    manifestVersion: { const: '2.0' },\n    manifestId: { type: 'string', minLength: 1 },\n    generatedAt: {\n      type: 'string',\n      pattern: '^\\\\d{4}-\\\\d{2}-\\\\d{2}T\\\\d{2}:\\\\d{2}:\\\\d{2}(?:\\\\.\\\\d+)?(?:Z|[+-]\\\\d{2}:\\\\d{2})$',\n    },\n    package: {\n      type: 'object',\n      additionalProperties: false,\n      required: ['name', 'version', 'sourceCommit'],\n      properties: {\n        name: { type: 'string', minLength: 1 },\n        version: { type: 'string', minLength: 1 },\n        sourceCommit: { type: 'string', minLength: 1 },\n        buildId: { type: 'string', minLength: 1 },\n        distributionUrl: { type: 'string', pattern: '^[a-zA-Z][a-zA-Z0-9+.-]*:' },\n      },\n    },\n    issuer: {\n      type: 'object',\n      additionalProperties: false,\n      required: ['did', 'verificationMethod'],\n      properties: {\n        did: { type: 'string', pattern: '^did:[a-z0-9]+:.+' },\n        verificationMethod: { type: 'string', pattern: '^did:[a-z0-9]+:.+#.+' },\n      },\n    },\n    compatibility: {\n      type: 'object',\n      additionalProperties: false,\n      required: ['engine', 'flowSchemaVersions', 'features'],\n      properties: {\n        engine: {\n          type: 'object',\n          additionalProperties: false,\n          required: ['versionRange'],\n          properties: {\n            versionRange: { type: 'string', minLength: 1 },\n          },\n        },\n        flowSchemaVersions: {\n          type: 'array',\n          minItems: 1,\n          uniqueItems: true,\n          items: { type: 'string', minLength: 1 },\n        },\n        features: {\n          type: 'array',\n          minItems: 1,\n          uniqueItems: true,\n          items: { type: 'string', minLength: 1 },\n        },\n      },\n    },\n    actions: {\n      type: 'array',\n      items: { $ref: '#/$defs/contract' },\n    },\n    primitives: {\n      type: 'array',\n      items: { $ref: '#/$defs/contract' },\n    },\n    integrity: {\n      type: 'object',\n      additionalProperties: false,\n      required: ['canonicalization', 'digest', 'signature'],\n      properties: {\n        canonicalization: { const: 'RFC8785' },\n        digest: {\n          type: 'object',\n          additionalProperties: false,\n          required: ['algorithm', 'value'],\n          properties: {\n            algorithm: { const: 'SHA-256' },\n            value: { type: 'string', pattern: '^sha256:[0-9a-f]{64}$' },\n          },\n        },\n        signature: {\n          type: 'object',\n          additionalProperties: false,\n          required: ['algorithm', 'verificationMethod', 'value'],\n          properties: {\n            algorithm: { type: 'string', minLength: 1 },\n            verificationMethod: { type: 'string', pattern: '^did:[a-z0-9]+:.+#.+' },\n            value: { type: 'string', minLength: 1 },\n          },\n        },\n      },\n    },\n  },\n  $defs: {\n    contract: {\n      type: 'object',\n      required: ['type', 'contractVersion'],\n      properties: {\n        type: { type: 'string', minLength: 1 },\n        contractVersion: { type: 'string', minLength: 1 },\n        aliases: {\n          type: 'array',\n          uniqueItems: true,\n          items: { type: 'string', minLength: 1 },\n        },\n      },\n    },\n  },\n} as const;\n","import Ajv2020 from 'ajv/dist/2020.js';\n\nimport { ACTION_MANIFEST_V2_SCHEMA } from './manifestV2.schema';\n\n/** JSON values accepted by the Manifest v2 portable contract. */\nexport type ManifestV2JsonValue = null | boolean | number | string | ManifestV2JsonValue[] | { [key: string]: ManifestV2JsonValue };\n\nexport interface ActionManifestV2Package {\n  name: string;\n  version: string;\n  sourceCommit: string;\n  buildId?: string;\n  distributionUrl?: string;\n}\n\nexport interface ActionManifestV2Issuer {\n  did: string;\n  verificationMethod: string;\n}\n\nexport interface ActionManifestV2Compatibility {\n  engine: {\n    versionRange: string;\n  };\n  flowSchemaVersions: string[];\n  features: string[];\n}\n\n/**\n * The complete action and primitive groups are introduced by the registry\n * migration. Keeping their extension fields JSON-only prevents executable\n * functions or class instances from crossing this portable boundary.\n */\nexport type ActionManifestV2Action = {\n  type: string;\n  contractVersion: string;\n  aliases?: string[];\n} & Record<string, ManifestV2JsonValue>;\n\nexport type ActionManifestV2Primitive = {\n  type: string;\n  contractVersion: string;\n  aliases?: string[];\n} & Record<string, ManifestV2JsonValue>;\n\n/** The unsigned, portable portion of an Action Manifest v2 envelope. */\nexport interface ActionManifestV2Payload {\n  manifestVersion: '2.0';\n  manifestId: string;\n  generatedAt: string;\n  package: ActionManifestV2Package;\n  issuer: ActionManifestV2Issuer;\n  compatibility: ActionManifestV2Compatibility;\n  actions: ActionManifestV2Action[];\n  primitives: ActionManifestV2Primitive[];\n}\n\nexport interface ActionManifestV2Integrity {\n  canonicalization: 'RFC8785';\n  digest: {\n    algorithm: 'SHA-256';\n    value: `sha256:${string}`;\n  };\n  signature: {\n    algorithm: string;\n    verificationMethod: string;\n    value: string;\n  };\n}\n\nexport type SignedActionManifestV2 = ActionManifestV2Payload & {\n  integrity: ActionManifestV2Integrity;\n};\n\ndeclare const verifiedActionManifestV2: unique symbol;\n\ntype DeepReadonly<T> = T extends readonly (infer Item)[] ? readonly DeepReadonly<Item>[] : T extends object ? { readonly [Key in keyof T]: DeepReadonly<T[Key]> } : T;\n\n/** A manifest that crossed the trust-policy boundary successfully. */\nexport type VerifiedActionManifestV2 = DeepReadonly<SignedActionManifestV2> & {\n  readonly [verifiedActionManifestV2]: true;\n};\n\nexport interface ActionManifestV2Signer {\n  issuerDid: string;\n  verificationMethod: string;\n  algorithm: string;\n  sign(data: Uint8Array): Promise<string>;\n}\n\nexport interface ActionManifestV2SignatureVerificationInput {\n  issuerDid: string;\n  verificationMethod: string;\n  algorithm: string;\n  data: Uint8Array;\n  signature: string;\n}\n\nexport interface ActionManifestV2TrustPolicy {\n  trustedIssuerDids: readonly string[];\n  revokedIssuerDids?: readonly string[];\n  allowedSignatureAlgorithms: readonly string[];\n  verifySignature(input: ActionManifestV2SignatureVerificationInput): Promise<boolean>;\n}\n\nexport type ActionManifestV2VerificationErrorCode =\n  | 'INVALID_MANIFEST'\n  | 'UNSUPPORTED_MANIFEST_VERSION'\n  | 'UNSIGNED_MANIFEST'\n  | 'SIGNER_MISMATCH'\n  | 'DUPLICATE_CONTRACT_TYPE'\n  | 'AMBIGUOUS_ALIAS'\n  | 'UNSORTED_CONTRACTS'\n  | 'UNTRUSTED_ISSUER'\n  | 'REVOKED_ISSUER'\n  | 'VERIFICATION_METHOD_MISMATCH'\n  | 'DISALLOWED_SIGNATURE_ALGORITHM'\n  | 'DIGEST_MISMATCH'\n  | 'INVALID_SIGNATURE';\n\nexport class ActionManifestV2VerificationError extends Error {\n  readonly code: ActionManifestV2VerificationErrorCode;\n\n  constructor(code: ActionManifestV2VerificationErrorCode, message: string) {\n    super(message);\n    this.name = 'ActionManifestV2VerificationError';\n    this.code = code;\n  }\n}\n\nconst validateSignedManifest = new Ajv2020({ allErrors: true, strict: false }).compile(ACTION_MANIFEST_V2_SCHEMA);\nconst SIGNATURE_DOMAIN = 'qi.action-manifest.v2\\0';\n\nfunction isPlainObject(value: object): value is Record<string, unknown> {\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n}\n\nfunction assertValidUnicode(value: string): void {\n  for (let index = 0; index < value.length; index += 1) {\n    const codeUnit = value.charCodeAt(index);\n    if (codeUnit >= 0xd800 && codeUnit <= 0xdbff) {\n      const next = value.charCodeAt(index + 1);\n      if (!(next >= 0xdc00 && next <= 0xdfff)) {\n        throw new TypeError('Manifest v2 contains an unpaired Unicode surrogate');\n      }\n      index += 1;\n    } else if (codeUnit >= 0xdc00 && codeUnit <= 0xdfff) {\n      throw new TypeError('Manifest v2 contains an unpaired Unicode surrogate');\n    }\n  }\n}\n\n/**\n * Serialize a Manifest v2 payload using the RFC 8785 JSON Canonicalization\n * Scheme. Invalid JSON-domain values are rejected rather than being silently\n * omitted or coerced.\n */\nexport function canonicalizeManifestV2Payload(payload: ActionManifestV2Payload): string {\n  const ancestors = new Set<object>();\n\n  const serialize = (value: unknown): string => {\n    if (value === null || typeof value === 'boolean') {\n      return JSON.stringify(value);\n    }\n\n    if (typeof value === 'string') {\n      assertValidUnicode(value);\n      return JSON.stringify(value);\n    }\n\n    if (typeof value === 'number') {\n      if (!Number.isFinite(value)) {\n        throw new TypeError('Manifest v2 contains a non-finite number');\n      }\n      return JSON.stringify(value);\n    }\n\n    if (typeof value !== 'object') {\n      throw new TypeError(`Manifest v2 contains a non-JSON value: ${typeof value}`);\n    }\n\n    if (ancestors.has(value)) {\n      throw new TypeError('Manifest v2 contains a circular reference');\n    }\n\n    ancestors.add(value);\n    try {\n      if (Array.isArray(value)) {\n        return `[${value.map((entry) => serialize(entry)).join(',')}]`;\n      }\n\n      if (!isPlainObject(value)) {\n        throw new TypeError('Manifest v2 contains a non-plain object');\n      }\n\n      return `{${Object.keys(value)\n        .sort()\n        .map((key) => {\n          assertValidUnicode(key);\n          return `${JSON.stringify(key)}:${serialize(value[key])}`;\n        })\n        .join(',')}}`;\n    } finally {\n      ancestors.delete(value);\n    }\n  };\n\n  return serialize(payload);\n}\n\n/** Compute the content address for the unsigned Manifest v2 payload. */\nexport async function computeActionManifestV2Digest(payload: ActionManifestV2Payload): Promise<string> {\n  if (!globalThis.crypto?.subtle) {\n    throw new Error('Web Crypto is required to digest an Action Manifest v2 contract');\n  }\n\n  const canonicalPayload = canonicalizeManifestV2Payload(payload);\n  const digest = await globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(canonicalPayload));\n  const hex = Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, '0')).join('');\n  return `sha256:${hex}`;\n}\n\nfunction signatureInput(digest: string): Uint8Array {\n  return new TextEncoder().encode(`${SIGNATURE_DOMAIN}${digest}`);\n}\n\nfunction schemaFailure(): ActionManifestV2VerificationError {\n  const details = (validateSignedManifest.errors || []).map((error) => `${error.instancePath || '/'} ${error.message || 'is invalid'}`).join('; ');\n  return new ActionManifestV2VerificationError('INVALID_MANIFEST', details ? `Action Manifest v2 is invalid: ${details}` : 'Action Manifest v2 is invalid');\n}\n\nfunction payloadFromSignedManifest(manifest: SignedActionManifestV2): ActionManifestV2Payload {\n  const { integrity: _integrity, ...payload } = manifest;\n  return payload;\n}\n\nfunction assertContractIdentities(payload: ActionManifestV2Payload): void {\n  const contracts = [...payload.actions, ...payload.primitives];\n  const canonicalTypes = new Set<string>();\n\n  for (const contract of contracts) {\n    if (canonicalTypes.has(contract.type)) {\n      throw new ActionManifestV2VerificationError('DUPLICATE_CONTRACT_TYPE', `Manifest contains duplicate canonical contract type: ${contract.type}`);\n    }\n    canonicalTypes.add(contract.type);\n  }\n\n  for (const [groupName, group] of [\n    ['actions', payload.actions],\n    ['primitives', payload.primitives],\n  ] as const) {\n    for (let index = 1; index < group.length; index += 1) {\n      if (group[index - 1].type > group[index].type) {\n        throw new ActionManifestV2VerificationError('UNSORTED_CONTRACTS', `Manifest ${groupName} must be sorted by canonical type`);\n      }\n    }\n  }\n\n  const claimedNames = new Map(Array.from(canonicalTypes, (type) => [type, type]));\n  for (const contract of contracts) {\n    const aliases = contract.aliases;\n    if (!Array.isArray(aliases)) continue;\n\n    for (const alias of aliases) {\n      const existingOwner = claimedNames.get(alias);\n      if (existingOwner) {\n        throw new ActionManifestV2VerificationError('AMBIGUOUS_ALIAS', `Manifest alias ${alias} conflicts with contract ${existingOwner}`);\n      }\n      claimedNames.set(alias, contract.type);\n    }\n  }\n}\n\nfunction deepFreeze<T extends object>(value: T): DeepReadonly<T> {\n  for (const child of Object.values(value)) {\n    if (typeof child === 'object' && child !== null && !Object.isFrozen(child)) {\n      deepFreeze(child);\n    }\n  }\n  return Object.freeze(value) as DeepReadonly<T>;\n}\n\n/**\n * Sign a portable Manifest v2 payload. The host owns key resolution and the\n * concrete signature algorithm; this module owns canonical bytes and issuer\n * binding.\n */\nexport async function signActionManifestV2(payload: ActionManifestV2Payload, signer: ActionManifestV2Signer): Promise<SignedActionManifestV2> {\n  if (signer.issuerDid !== payload.issuer.did || signer.verificationMethod !== payload.issuer.verificationMethod) {\n    throw new ActionManifestV2VerificationError('SIGNER_MISMATCH', 'The Manifest v2 signer does not match the declared issuer verification method');\n  }\n\n  assertContractIdentities(payload);\n  let digest: string;\n  try {\n    digest = await computeActionManifestV2Digest(payload);\n  } catch (error) {\n    throw new ActionManifestV2VerificationError(\n      'INVALID_MANIFEST',\n      error instanceof Error ? `Action Manifest v2 cannot be canonicalized: ${error.message}` : 'Action Manifest v2 cannot be canonicalized'\n    );\n  }\n  const signature = await signer.sign(signatureInput(digest));\n  if (!signature) {\n    throw new ActionManifestV2VerificationError('INVALID_SIGNATURE', 'The Manifest v2 signer returned an empty signature');\n  }\n\n  const signed: SignedActionManifestV2 = {\n    ...payload,\n    integrity: {\n      canonicalization: 'RFC8785',\n      digest: {\n        algorithm: 'SHA-256',\n        value: digest as `sha256:${string}`,\n      },\n      signature: {\n        algorithm: signer.algorithm,\n        verificationMethod: signer.verificationMethod,\n        value: signature,\n      },\n    },\n  };\n\n  if (!validateSignedManifest(signed)) {\n    throw schemaFailure();\n  }\n  assertContractIdentities(payload);\n\n  return signed;\n}\n\n/**\n * Load a signed manifest across the execution trust boundary. Every failure\n * throws; this API never returns a partially trusted or downgraded contract.\n */\nexport async function verifyActionManifestV2(candidate: unknown, trustPolicy: ActionManifestV2TrustPolicy): Promise<VerifiedActionManifestV2> {\n  if (typeof candidate !== 'object' || candidate === null || !('manifestVersion' in candidate) || (candidate as { manifestVersion?: unknown }).manifestVersion !== '2.0') {\n    throw new ActionManifestV2VerificationError('UNSUPPORTED_MANIFEST_VERSION', 'Only Action Manifest version 2.0 can cross this execution boundary');\n  }\n\n  if (!('integrity' in candidate) || typeof (candidate as { integrity?: unknown }).integrity !== 'object') {\n    throw new ActionManifestV2VerificationError('UNSIGNED_MANIFEST', 'A signature and digest are required to load Action Manifest v2 for execution');\n  }\n\n  if (!validateSignedManifest(candidate)) {\n    throw schemaFailure();\n  }\n\n  const manifest = candidate as SignedActionManifestV2;\n  const { issuer, integrity } = manifest;\n  assertContractIdentities(manifest);\n\n  if (!trustPolicy.trustedIssuerDids.includes(issuer.did)) {\n    throw new ActionManifestV2VerificationError('UNTRUSTED_ISSUER', `Manifest issuer is not trusted: ${issuer.did}`);\n  }\n  if (trustPolicy.revokedIssuerDids?.includes(issuer.did)) {\n    throw new ActionManifestV2VerificationError('REVOKED_ISSUER', `Manifest issuer is revoked: ${issuer.did}`);\n  }\n  if (integrity.signature.verificationMethod !== issuer.verificationMethod || !integrity.signature.verificationMethod.startsWith(`${issuer.did}#`)) {\n    throw new ActionManifestV2VerificationError('VERIFICATION_METHOD_MISMATCH', 'The signature verification method does not belong to the declared manifest issuer');\n  }\n  if (!trustPolicy.allowedSignatureAlgorithms.includes(integrity.signature.algorithm)) {\n    throw new ActionManifestV2VerificationError('DISALLOWED_SIGNATURE_ALGORITHM', `Manifest signature algorithm is not allowed: ${integrity.signature.algorithm}`);\n  }\n\n  let digest: string;\n  try {\n    digest = await computeActionManifestV2Digest(payloadFromSignedManifest(manifest));\n  } catch (error) {\n    throw new ActionManifestV2VerificationError(\n      'INVALID_MANIFEST',\n      error instanceof Error ? `Action Manifest v2 cannot be canonicalized: ${error.message}` : 'Action Manifest v2 cannot be canonicalized'\n    );\n  }\n  if (digest !== integrity.digest.value) {\n    throw new ActionManifestV2VerificationError('DIGEST_MISMATCH', 'Manifest payload does not match its signed digest');\n  }\n\n  let validSignature = false;\n  try {\n    validSignature = await trustPolicy.verifySignature({\n      issuerDid: issuer.did,\n      verificationMethod: integrity.signature.verificationMethod,\n      algorithm: integrity.signature.algorithm,\n      data: signatureInput(digest),\n      signature: integrity.signature.value,\n    });\n  } catch {\n    validSignature = false;\n  }\n  if (!validSignature) {\n    throw new ActionManifestV2VerificationError('INVALID_SIGNATURE', 'Manifest signature verification failed');\n  }\n\n  const trustedSnapshot = JSON.parse(JSON.stringify(manifest)) as SignedActionManifestV2;\n  return deepFreeze(trustedSnapshot) as VerifiedActionManifestV2;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-NCSGIRRQ.js

@@ -0,0 +1,28 @@
+// src/core/lib/yjsTypes.ts
+function getExistingYMap(yDoc, key) {
+  if (!yDoc.share.has(key)) return void 0;
+  return yDoc.getMap(key);
+}
+function isYMapLike(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  return typeof candidate.get === "function" && typeof candidate.set === "function" && typeof candidate.has === "function" && typeof candidate.forEach === "function";
+}
+function isYXmlElementLike(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  return typeof candidate.nodeName === "string" && typeof candidate.getAttribute === "function" && typeof candidate.getAttributes === "function";
+}
+function isYDocLike(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  return typeof candidate.getMap === "function" && typeof candidate.getXmlFragment === "function" && typeof candidate.transact === "function";
+}
+
+export {
+  getExistingYMap,
+  isYMapLike,
+  isYXmlElementLike,
+  isYDocLike
+};
+//# sourceMappingURL=chunk-NCSGIRRQ.js.map

package/dist/chunk-NCSGIRRQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/lib/yjsTypes.ts"],"sourcesContent":["import type * as Y from 'yjs';\n\n/**\n * Resolve an existing top-level Y.Map without creating an absent shared type.\n *\n * A remote update may leave `Doc.share` holding an unspecialized\n * `AbstractType` until `getMap` is called locally. Checking `share.has` first\n * distinguishes that harmless local specialization from creating a brand-new\n * shared map on an otherwise empty document.\n */\nexport function getExistingYMap<T = unknown>(yDoc: Y.Doc, key: string): Y.Map<T> | undefined {\n  if (!yDoc.share.has(key)) return undefined;\n  return yDoc.getMap<T>(key);\n}\n\n/**\n * Structural Y.Map guard.\n *\n * Yjs is a peer dependency and local multi-repo development can legitimately\n * load two compatible package instances. `instanceof Y.Map` then rejects a\n * real map created by the consumer's instance. Shared-state boundaries use\n * this guard so behavior follows the CRDT shape rather than constructor\n * identity.\n */\nexport function isYMapLike<T = unknown>(value: unknown): value is Y.Map<T> {\n  if (!value || typeof value !== 'object') return false;\n  const candidate = value as {\n    get?: unknown;\n    set?: unknown;\n    has?: unknown;\n    forEach?: unknown;\n  };\n  return typeof candidate.get === 'function' && typeof candidate.set === 'function' && typeof candidate.has === 'function' && typeof candidate.forEach === 'function';\n}\n\n/**\n * Structural Y.XmlElement guard.\n *\n * `nodeName` is what separates an element from Y.XmlText/Y.XmlHook inside the\n * same fragment, so checking it (plus the attribute API) matches exactly the\n * nodes `instanceof Y.XmlElement` accepted — without tying the answer to which\n * yjs instance constructed the document. A deployed host that loads yjs as CJS\n * while this package's dist loads it as ESM gets two instances of the same\n * version; constructor checks then reject every real element and a populated\n * document reads as empty.\n */\nexport function isYXmlElementLike(value: unknown): value is Y.XmlElement {\n  if (!value || typeof value !== 'object') return false;\n  const candidate = value as {\n    nodeName?: unknown;\n    getAttribute?: unknown;\n    getAttributes?: unknown;\n  };\n  return typeof candidate.nodeName === 'string' && typeof candidate.getAttribute === 'function' && typeof candidate.getAttributes === 'function';\n}\n\n/** Structural Y.Array guard — same dual-instance rationale as isYMapLike. */\nexport function isYArrayLike<T = unknown>(value: unknown): value is Y.Array<T> {\n  if (!value || typeof value !== 'object') return false;\n  const candidate = value as {\n    toArray?: unknown;\n    push?: unknown;\n    length?: unknown;\n  };\n  return typeof candidate.toArray === 'function' && typeof candidate.push === 'function' && typeof candidate.length === 'number';\n}\n\n/** Structural Y.Doc guard — same dual-instance rationale as isYMapLike. */\nexport function isYDocLike(value: unknown): value is Y.Doc {\n  if (!value || typeof value !== 'object') return false;\n  const candidate = value as {\n    getMap?: unknown;\n    getXmlFragment?: unknown;\n    transact?: unknown;\n  };\n  return typeof candidate.getMap === 'function' && typeof candidate.getXmlFragment === 'function' && typeof candidate.transact === 'function';\n}\n"],"mappings":";AAUO,SAAS,gBAA6B,MAAa,KAAmC;AAC3F,MAAI,CAAC,KAAK,MAAM,IAAI,GAAG,EAAG,QAAO;AACjC,SAAO,KAAK,OAAU,GAAG;AAC3B;AAWO,SAAS,WAAwB,OAAmC;AACzE,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAMlB,SAAO,OAAO,UAAU,QAAQ,cAAc,OAAO,UAAU,QAAQ,cAAc,OAAO,UAAU,QAAQ,cAAc,OAAO,UAAU,YAAY;AAC3J;AAaO,SAAS,kBAAkB,OAAuC;AACvE,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAKlB,SAAO,OAAO,UAAU,aAAa,YAAY,OAAO,UAAU,iBAAiB,cAAc,OAAO,UAAU,kBAAkB;AACtI;AAcO,SAAS,WAAW,OAAgC;AACzD,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAKlB,SAAO,OAAO,UAAU,WAAW,cAAc,OAAO,UAAU,mBAAmB,cAAc,OAAO,UAAU,aAAa;AACnI;","names":[]}