@artblocks/abx-cli 0.1.0-alpha.17 → 0.1.0-alpha.19

package/dist/mintpage.d.ts

@@ -40,7 +40,9 @@ export interface MintPageArtifact {
     }>;
     steps: string[];
 }
-/** Public, keyless RPCs safe to embed in a public site. Extend as chains are added. */
+/** Public, keyless RPCs safe to embed in a public site. Extend as chains are added.
+ *  base-sepolia is the toolkit's DEFAULT chain — its absence here meant every default-chain
+ *  deploy needed a manual --rpc just to scaffold its own mint page (integrator-reported). */
 export declare const PUBLIC_RPC: Record<number, string>;
 export declare function mintPageArtifact(o: MintPageOptions): MintPageArtifact;
 //# sourceMappingURL=mintpage.d.ts.map

package/dist/mintpage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mintpage.d.ts","sourceRoot":"","sources":["../src/mintpage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,cAAc,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAC9C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,uFAAuF;AACvF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG7C,CAAC;AAubF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,eAAe,GAAG,gBAAgB,CA0BrE"}
+{"version":3,"file":"mintpage.d.ts","sourceRoot":"","sources":["../src/mintpage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,cAAc,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAC9C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;6FAE6F;AAC7F,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK7C,CAAC;AAkbF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,eAAe,GAAG,gBAAgB,CA0BrE"}

package/dist/mintpage.js

@@ -19,10 +19,15 @@
  * Pure module: returns the artifact files + the exact next-step commands. The CLI writes the files and
  * prints the steps; `vercel` / `next dev` run in the creator's own account/machine — they own that step.
  */
-/** Public, keyless RPCs safe to embed in a public site. Extend as chains are added. */
+import { readSdkVersion } from './update-check.js';
+/** Public, keyless RPCs safe to embed in a public site. Extend as chains are added.
+ *  base-sepolia is the toolkit's DEFAULT chain — its absence here meant every default-chain
+ *  deploy needed a manual --rpc just to scaffold its own mint page (integrator-reported). */
 export const PUBLIC_RPC = {
     1: 'https://ethereum-rpc.publicnode.com',
     11155111: 'https://ethereum-sepolia-rpc.publicnode.com',
+    8453: 'https://mainnet.base.org',
+    84532: 'https://sepolia.base.org',
 };
 const slug = (s) => s
     .toLowerCase()
@@ -43,6 +48,11 @@ function packageJson(o) {
             react: '^19.0.0',
             'react-dom': '^19.0.0',
             viem: '^2.21.0',
+            // Pinned to THIS CLI's own version, caret-ranged — the CLI and sdk version-bump together in
+            // this repo's changesets flow, so "the version that scaffolded this app" is exactly the
+            // floor that's guaranteed to have makePublicClient/readSaleConfig/the `/abi` subpath (this
+            // refactor). INVARIANT: an sdk older than that will be missing one of those exports.
+            '@artblocks/abx-sdk': '^' + readSdkVersion(),
         },
         devDependencies: {
             typescript: '^5.6.0',
@@ -130,55 +140,53 @@ export const chain = defineChain({
   rpcUrls: {default: {http: [RPC_URL]}},
 });
 `;
-const LIB_ABI = `// Minimal ABIs — only what the mint page reads/writes.
-export const minterAbi = [
-  {
-    type: 'function',
-    name: 'sales',
-    stateMutability: 'view',
-    inputs: [{name: 'token', type: 'address'}],
-    outputs: [
-      {name: 'configured', type: 'bool'},
-      {name: 'paymentToken', type: 'address'},
-      {name: 'price', type: 'uint256'},
-      {name: 'allocation', type: 'uint256'},
-      {name: 'sold', type: 'uint256'},
-    ],
-  },
-  {type: 'function', name: 'purchase', stateMutability: 'payable', inputs: [{name: 'token', type: 'address'}], outputs: [{name: 'tokenId', type: 'uint256'}]},
-  {type: 'function', name: 'purchaseTo', stateMutability: 'payable', inputs: [{name: 'token', type: 'address'}, {name: 'to', type: 'address'}], outputs: [{name: 'tokenId', type: 'uint256'}]},
-] as const;
+const LIB_ABI = `// Minter + token ABIs, sourced from the shared SDK instead of hand-typed here — one definition
+// that tracks the deployed contracts (the ABX repo's 'pnpm sync-abis' regenerates it from the
+// contracts themselves), so this file can never drift the way a hand-copied fragment can.
+//
+// name / totalSupply / maxInvocations / paused / tokenURI are identical fragments on every ABX
+// Series contract type (Image or Code) — importing both and spreading is harmless (duplicate
+// fragments, byte-identical shape) and keeps this working whichever Series type backs your
+// collection, without this app needing to know which one it is.
+// (A rename re-export — 'export {x as y} from …' — of a subpath import tripped up Next's bundler
+// here; a plain import + local const assignment is the form that survives the production build.)
+import {abxFixedPriceMinterAbi, seriesImageAbi, seriesCodeAbi} from '@artblocks/abx-sdk/abi';
 
-export const tokenAbi = [
-  {type: 'function', name: 'name', stateMutability: 'view', inputs: [], outputs: [{type: 'string'}]},
-  {type: 'function', name: 'totalSupply', stateMutability: 'view', inputs: [], outputs: [{type: 'uint256'}]},
-  {type: 'function', name: 'maxInvocations', stateMutability: 'view', inputs: [], outputs: [{type: 'uint256'}]},
-  {type: 'function', name: 'paused', stateMutability: 'view', inputs: [], outputs: [{type: 'bool'}]},
-  {type: 'function', name: 'tokenURI', stateMutability: 'view', inputs: [{name: 'id', type: 'uint256'}], outputs: [{type: 'string'}]},
-] as const;
+export const minterAbi = abxFixedPriceMinterAbi;
+export const tokenAbi = [...seriesImageAbi, ...seriesCodeAbi] as const;
 `;
 const LIB_META = `// Read a token's image + name from tokenURI(id), directly from chain. Handles data: URIs
 // (on-chain tokens) and http/ipfs/ar locators (off-chain custody). No backend.
-import {createPublicClient, http} from 'viem';
-import {chain} from './chain';
-import {TOKEN} from './config';
+//
+// The read client is the SDK's browser-safe makePublicClient, given an EXPLICIT rpcUrls list —
+// never env resolution (there is no server .env in a static site, and the SDK's own
+// ABX_RPC_URLS/ABX_CHAIN conventions would silently no-op in a browser bundle anyway; an explicit
+// override short-circuits that lookup entirely). One URL behaves exactly like a plain http()
+// transport; paste a comma-separated NEXT_PUBLIC_RPC_URL to get the same fallback-transport
+// failover the CLI/indexer get. Its attached chain metadata is the SDK's own default and is
+// informational only for these plain reads — the WALLET's chain (used for the mint tx) is the one
+// built in ./chain from your real NEXT_PUBLIC_CHAIN_ID/NAME, unaffected by this.
+//
+// Gateway + data: URI parsing go through the SAME sdk helpers the CLI/indexer use
+// (gatewayUrlFor/resolveGatewayBase, parseDataUri) instead of a hand-rolled 'ipfs://'-slicing body —
+// one implementation of "how to read a locator" instead of this app quietly re-deriving its own.
+import {makePublicClient, gatewayUrlFor, resolveGatewayBase, parseDataUri} from '@artblocks/abx-sdk';
+import {RPC_URL, TOKEN} from './config';
 import {tokenAbi} from './abi';
 
-export const publicClient = createPublicClient({chain, transport: http()});
+export const publicClient = makePublicClient({rpcUrls: RPC_URL.split(',').map((u) => u.trim()).filter(Boolean)});
 
 export function toGateway(u: string): string {
   if (!u) return '';
-  if (u.startsWith('ipfs://')) return 'https://ipfs.io/ipfs/' + u.slice(7);
-  if (u.startsWith('ar://')) return 'https://arweave.net/' + u.slice(5);
+  if (u.startsWith('ipfs://')) return gatewayUrlFor('ipfs', u.slice(7), resolveGatewayBase('ipfs'));
+  if (u.startsWith('ar://')) return gatewayUrlFor('arweave', u.slice(5), resolveGatewayBase('arweave'));
   return u;
 }
 
 async function fetchJson(uri: string): Promise<any> {
-  if (uri.startsWith('data:')) {
-    const comma = uri.indexOf(',');
-    const header = uri.slice(5, comma);
-    const body = uri.slice(comma + 1);
-    const text = header.includes('base64') ? atob(body) : decodeURIComponent(body);
+  const parsed = parseDataUri(uri);
+  if (parsed) {
+    const text = parsed.base64 ? atob(parsed.body) : decodeURIComponent(parsed.body);
     return JSON.parse(text);
   }
   const res = await fetch(toGateway(uri));
@@ -252,22 +260,15 @@ const APP_MINT_CLIENT = `'use client';
 import {useCallback, useEffect, useState} from 'react';
 import {createWalletClient, custom, formatEther} from 'viem';
 import {chain} from '../lib/chain';
+import {readSaleConfig, type SaleConfig} from '@artblocks/abx-sdk';
 import {CHAIN_ID, CHAIN_NAME, COLLECTION_NAME, EXPLORER, MINTER, PAGE_SIZE, TOKEN} from '../lib/config';
 import {minterAbi, tokenAbi} from '../lib/abi';
 import {publicClient, readTokenMeta, type TokenMeta} from '../lib/meta';
 
 const ZERO = '0x0000000000000000000000000000000000000000';
 
-interface Sale {
-  configured: boolean;
-  paymentToken: string;
-  price: bigint;
-  allocation: bigint;
-  sold: bigint;
-}
-
 export default function Mint() {
-  const [sale, setSale] = useState<Sale | null>(null);
+  const [sale, setSale] = useState<SaleConfig | null>(null);
   const [supply, setSupply] = useState(0);
   const [maxInv, setMaxInv] = useState(0);
   const [paused, setPaused] = useState(false);
@@ -278,8 +279,7 @@ export default function Mint() {
   const [msg, setMsg] = useState('');
 
   const refresh = useCallback(async () => {
-    const s = (await publicClient.readContract({address: MINTER, abi: minterAbi, functionName: 'sales', args: [TOKEN]})) as any;
-    setSale({configured: s[0], paymentToken: s[1], price: s[2], allocation: s[3], sold: s[4]});
+    setSale(await readSaleConfig(publicClient, MINTER, TOKEN));
     const [ts, mx, pz] = await Promise.all([
       publicClient.readContract({address: TOKEN, abi: tokenAbi, functionName: 'totalSupply'}),
       publicClient.readContract({address: TOKEN, abi: tokenAbi, functionName: 'maxInvocations'}),

package/dist/mintpage.js.map

@@ -1 +1 @@
-{"version":3,"file":"mintpage.js","sourceRoot":"","sources":["../src/mintpage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mintpage.js","sourceRoot":"","sources":["../src/mintpage.ts"],"names":[],"mappings":"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"}

package/dist/output.d.ts

@@ -0,0 +1,137 @@
+import { SelfHostIndexer } from '@artblocks/abx-indexer';
+import { type Address, type ProjectState, type PublicClient, type SendTx } from '@artblocks/abx-sdk';
+import { type Flags } from './flags.js';
+export declare const c: {
+    reset: string;
+    dim: string;
+    bold: string;
+    green: string;
+    purple: string;
+    orange: string;
+    red: string;
+};
+export declare const g: (s: string) => string;
+export declare const p: (s: string) => string;
+export declare const dim: (s: string) => string;
+export declare const bold: (s: string) => string;
+export declare let stepN: number;
+export declare const step: (s: string) => void;
+export declare const ok: (s: string) => void;
+export declare const info: (s: string) => void;
+export declare const warn: (s: string) => void;
+export declare function allowLargeScan(flags: Flags): void;
+/**
+ * Resolve the scan floor (fromBlock) for an add/index — the CLI-side shell around the SDK's
+ * {@link sdkResolveScanFloor}: builds the client, forwards `--from-block`, and narrates its two
+ * possible events (the SDK never prints). See the SDK function's doc comment for the "why" (never
+ * a silent genesis default).
+ */
+export declare function resolveScanFloor(address: Address, localFromBlock: string | undefined, flags: Flags): Promise<string>;
+/**
+ * The trust-anchor gate: a factory is THE address platforms allowlist by, so a missing
+ * manifest entry must NEVER silently mint a new "canonical" — that fragments trust (and
+ * a stale SDK would duplicate factories on real chains). Degrade to guidance; deploying
+ * a private trust anchor is an explicit choice (`--bootstrap-factory`).
+ */
+export declare function refuseMissingFactory(kind: string, envVar: string, reason: string): never;
+/** A `SendTx` that defers `makeWalletClient`/`makeHotSender` construction until the first actual
+ *  send — trust-anchor bootstrap is rare (an existing, current anchor is the common case), so the
+ *  happy path must never require a signing key. Memoized so a multi-tx bootstrap (the SeriesCode
+ *  factory: 2 libraries + the linked factory itself) reuses ONE sender — and its nonce tracking —
+ *  rather than a fresh one per send. */
+export declare function lazyBootstrapSender(publicClient: PublicClient): SendTx;
+/** Get (or deploy) the chain's canonical 1/1 clone factory — narrates the SDK's `ensureFactory`
+ *  (anchors.ts), which owns the resolve/verify/bootstrap logic; this keeps only the exact console
+ *  output plus the exit-messaging refusal (`refuseMissingFactory`), which stays CLI-side since the
+ *  SDK doesn't know a UX's flag names. `quiet` suppresses only the happy-path reuse line (the demo
+ *  resolves the factory without making a teaching moment of it) — everything else always prints. */
+export declare function ensureFactory(override?: string, allowBootstrap?: boolean, quiet?: boolean): Promise<Address>;
+/** Get (or deploy) the chain's `SeriesImageFactory` — the sibling of {@link ensureFactory}.
+ *  Narrates the SDK's `ensureSeriesFactory` (anchors.ts), which owns the resolve/verify/bootstrap
+ *  logic. */
+export declare function ensureSeriesFactory(override?: string, allowBootstrap?: boolean): Promise<Address>;
+/** Get (or deploy) the chain's shared `AbxMetadataRenderer` — narrates the SDK's `ensureRenderer`
+ *  (anchors.ts), which also self-heals to the CREATE2-deterministic address before deploying. No
+ *  `allowBootstrap` gate here (unlike the three clone factories) — the renderer isn't a platform
+ *  allowlist entry, so there's nothing to refuse; a stale/missing one always just gets redeployed. */
+export declare function ensureRenderer(override?: string): Promise<Address>;
+/** The code-project trust anchor — narrates the SDK's `ensureSeriesCodeFactory` (anchors.ts),
+ *  which owns the resolve/bootstrap logic (a sandbox / fresh chain links + deploys the two
+ *  write-path libraries then the factory in-flight; see {@link deploySeriesCodeFactory}). */
+export declare function ensureSeriesCodeFactory(publicClient: PublicClient, override?: string, allowBootstrap?: boolean): Promise<Address>;
+/** The canonical seed source — narrates the SDK's `ensureSeedSource` (anchors.ts): a clean keyless
+ *  singleton (like the renderer / chunk store / minter), so CREATE2 lands at THE canonical address
+ *  on any chain. Resolves from the manifest, self-heals to the predicted address (deployed but not
+ *  yet repointed), else auto-deploys via CREATE2. */
+export declare function ensureSeedSource(publicClient: PublicClient): Promise<Address>;
+/**
+ * Refuse a port that's already bound, with a formatted one-liner naming the port and the fix.
+ *
+ * Without this, `listen()` has no `'error'` handler and EADDRINUSE reaches Node's default handler:
+ * the creator gets a raw stack trace through `node:net` and our own `dist/` paths, which reads as a
+ * crash inside abx rather than "something else is on this port" — and it's the one unformatted error
+ * surface in a CLI where every other error is formatted. `preview`'s default port colliding with a
+ * studio left running in another terminal was reported as especially hard to diagnose.
+ */
+export declare function assertPortFree(port: number, cmd: string): Promise<void>;
+/** Is a TCP port already bound on localhost? Used to preflight a serve BEFORE spending a tx. */
+export declare function portInUse(port: number): Promise<boolean>;
+/**
+ * Index a project we *just* deployed — and don't believe a zero.
+ *
+ * `eth_getLogs` is read-after-write inconsistent on load-balanced RPCs: `waitForTransactionReceipt`
+ * resolves against a node that has the block, then the log query lands on one that doesn't yet, and
+ * returns an empty set for a block we KNOW contains our deploy. The old code took that single read at
+ * face value, printed `✓ reconstructed 0 events`, stored the empty projection, and served an empty
+ * dashboard — a first-run that looks like the toolkit simply doesn't work. It reproduced 100% of the
+ * time on `https://sepolia.base.org`, which is the DEFAULT endpoint when there's no `.env`, i.e. the
+ * documented first run was the broken path. The same block returned all 9 logs seconds later.
+ *
+ * We have the one thing that makes this checkable: we just minted, so the spine cannot be empty.
+ * So verify instead of trusting — re-scan at a constant delay until events appear, and if they
+ * never do, say so as a FAILURE with the recovery command rather than dressing a zero up as a ✓.
+ */
+export declare function reindexAfterDeploy(indexer: SelfHostIndexer, address: Address, opts?: {
+    attempts?: number;
+    delayMs?: number;
+}): Promise<{
+    state: ProjectState;
+    elapsedMs: number;
+}>;
+export declare function loadEffects(): Promise<typeof import('@artblocks/abx-effects')>;
+/**
+ * The publish topology's one hard prerequisite, checked BEFORE any capture.
+ *
+ * A resolver that doesn't share this machine's disk serves referenced output (the still, a video, a
+ * model) by **redirect** — so it needs a URL, and it refuses the bytes (`specs/protocol/effects.md →
+ * Bound vs referenced`). A backend that can't name a locator therefore has no publish lane at all,
+ * and every render against one would be work spent to earn a 400.
+ *
+ * So this refuses up front and names the ways out, rather than warning and letting the render run.
+ * It deliberately does NOT pick a backend for the operator: which store holds their art — and which
+ * gateway serves it — is theirs to decide. The three that work are peers, not a ranking: `https://`
+ * from S3/R2, an IPFS gateway, and Arweave are all fine, because derived output is re-creatable and
+ * the only real requirement is that a third party can fetch it.
+ */
+export declare function requirePublishableBackend(flags: Flags, what: string): void;
+export declare function printServing(url: string, address?: Address): void;
+/** Walk up from the CLI source to the workspace root (the dir with pnpm-workspace.yaml). Returns
+ *  null when running from a published install (no workspace) — where --from-source doesn't apply. */
+export declare function findRepoRoot(): string | null;
+export declare function keepAlive(): Promise<void>;
+/**
+ * Pick the canonical factory for a clone being added — the CLI-side shell around the SDK's
+ * {@link sdkDetectCanonicalFactory} (which does the actual multicall probe; see its doc comment).
+ * Shared by `add`'s local + remote paths (project.ts) and the deploy family's post-setup local
+ * register (deploy.ts, via {@link registerAndIndexLocally}).
+ */
+export declare function detectCanonicalFactory(address: Address, override?: string, stored?: string | null): Promise<Address | undefined>;
+/**
+ * Register + index a project LOCALLY (this node's own SQLite-backed projection) — the core of
+ * `abx add`'s non-`--remote` path, factored out here because it's ALSO how `deploy` / `deploy-series`
+ * / `deploy-code` register the project they just deployed (see cmdAdd in commands/project.ts, whose
+ * local branch is a thin call to this). Kept self-sufficient (recomputes any `--attributes`/`--traits`
+ * edit from `flags` itself) so it never depends on a caller's local variables.
+ */
+export declare function registerAndIndexLocally(address: Address, flags: Flags): Promise<void>;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAYA,OAAO,EAAC,eAAe,EAAC,MAAM,wBAAwB,CAAC;AACvD,OAAO,EACL,KAAK,OAAO,EAIZ,KAAK,YAAY,EACjB,KAAK,YAAY,EAEjB,KAAK,MAAM,EAeZ,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAC,KAAK,KAAK,EAAC,MAAM,YAAY,CAAC;AAItC,eAAO,MAAM,CAAC;;;;;;;;CAGb,CAAC;AACF,eAAO,MAAM,CAAC,GAAI,GAAG,MAAM,WAA+B,CAAC;AAC3D,eAAO,MAAM,CAAC,GAAI,GAAG,MAAM,WAAgC,CAAC;AAC5D,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,WAA6B,CAAC;AAC3D,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,WAA8B,CAAC;AAC7D,eAAO,IAAI,KAAK,QAAI,CAAC;AACrB,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,SAAqD,CAAC;AACpF,eAAO,MAAM,EAAE,GAAI,GAAG,MAAM,SAAsC,CAAC;AACnE,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,SAAiC,CAAC;AAChE,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,SAAoD,CAAC;AAKnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAEjD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAU1H;AAGD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAQxF;AAED;;;;wCAIwC;AACxC,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAStE;AAED;;;;oGAIoG;AACpG,wBAAsB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,cAAc,UAAQ,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAuC9G;AAGD;;aAEa;AACb,wBAAsB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CA8BrG;AAGD;;;sGAGsG;AACtG,wBAAsB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBxE;AAED;;6FAE6F;AAC7F,wBAAsB,uBAAuB,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CA4BrI;AAED;;;qDAGqD;AACrD,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CASnF;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E;AAED,gGAAgG;AAChG,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAM,GAC/C,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAC,CAAC,CAqBnD;AAMD,wBAAsB,WAAW,IAAI,OAAO,CAAC,cAAc,wBAAwB,CAAC,CAAC,CAUpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA8B1E;AAGD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,QAkB1D;AAED;qGACqG;AACrG,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAS5C;AAED,wBAAgB,SAAS,kBAMxB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAG9B;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CA2E3F"}