@artblocks/abx-sdk 0.1.0-alpha.3 → 0.1.0-alpha.30

package/dist/onchain-uri.d.ts

@@ -0,0 +1,110 @@
+/**
+ * The on-chain tokenURI lane for code projects (`abx deploy-code --onchain-uri`) — pure leg
+ * composition + the verify-time honesty reads, all unit-testable with a mocked client.
+ *
+ * The lane (site/content/docs/protocol/code-projects.mdx → "The canonical generator — AbxGenerator" +
+ * site/content/docs/protocol/metadata.mdx → "URI resolution"): the collection-scope `animation_url`
+ * field points at the canonical generator via the `renderer` representation
+ * (`abi.encode(address)`), and the token's `tokenURIRenderer` toggles tokenURI to the canonical
+ * on-chain metadata renderer (`setContractURIRenderer` does the same for contractURI). Both ride
+ * the EXISTING setup multicall, before the mints.
+ *
+ * The param surface is NOT part of that wiring: params enumerate ON-CHAIN (`contractParamKeys` /
+ * `tokenParamKeys`, maintained by the write paths themselves), so the generator reads the key set
+ * straight from the token. The old `params.keys` CSV convention is retired — nothing writes it any
+ * more.
+ */
+import { type Address, type Hex } from 'viem';
+import { type GeneratorReadClient, type GeneratorStatus } from './generator.js';
+import { type DepCheck, type ParsedDependencyRef } from './deps.js';
+import type { ProjectState } from './types.js';
+/**
+ * The `--onchain-uri` legs of the setup multicall, in order:
+ *   1. collection-scope `animation_url` field → representation `renderer`,
+ *      value `abi.encode(generator)` (the canonical generator computes the live view on-chain);
+ *   2. `setTokenURIRenderer(metadataRenderer)` — tokenURI resolves ON-CHAIN from here on;
+ *   3. `setContractURIRenderer(metadataRenderer)` — contractURI too (parity with the 1/1 lane).
+ * Placed BEFORE the mint legs so every token is born with the on-chain lane fully configured.
+ *
+ * There is no param leg: the generator enumerates the param surface from the token itself
+ * (`contractParamKeys` / `tokenParamKeys`), so there is nothing for a deploy to declare.
+ */
+export declare function onchainUriSetupCalls(args: {
+    generator: Address;
+    metadataRenderer: Address;
+}): Hex[];
+/** The SET param keys: `contractParamKeys()`, plus `tokenParamKeys(tokenId)` when a token is named.
+ *  Null when the getters are absent — a LEGACY project deployed before enumeration shipped (or a
+ *  token type with no Params extension at all). */
+export declare function readSetParamKeys(client: GeneratorReadClient, contract: Address, tokenId?: bigint): Promise<{
+    contract: string[];
+    token: string[];
+} | null>;
+/** The DECLARED (governed) keys: `paramSchemaKeys()`, append-only — including keys declared but
+ *  never yet written, which are otherwise undiscoverable. Null on a legacy project. */
+export declare function readParamSchemaKeys(client: GeneratorReadClient, contract: Address): Promise<string[] | null>;
+/** The project's three param-lifecycle hook addresses (`paramHooks()`), zeroes included — null on a
+ *  project with no ConfigurableParams surface (a 1/1, a plain Series, an image edition).
+ *
+ *  The `transferHook` in this trio is a **veto**: its revert fails the transfer, and a mint is a
+ *  transfer from `0x0`, so a reverting hook stops minting too. Whether the trio can still change is
+ *  a separate read — `readParamHooksLocked` (ops.ts), or the `ParamHooksFrozen` fold. */
+export declare function readParamHooks(client: GeneratorReadClient, contract: Address): Promise<{
+    configureHook: Address;
+    augmentHook: Address;
+    transferHook: Address;
+} | null>;
+/** Does this token expose the enumeration surface at all? The one-call probe behind the repoint
+ *  guard: the canonical generator reads params from chain, so pointing a token that lacks these
+ *  getters at it makes every param silently invisible. */
+export declare function hasParamEnumeration(client: GeneratorReadClient, contract: Address): Promise<boolean>;
+/** What the deploy can honestly promise about the generator's template branch, derived from
+ *  the selection-time dependency report (never a new RPC): chain-complete iff every registry
+ *  dep has proven ON-CHAIN bytes (OnChain refs read their data contract directly, so they
+ *  count as on-chain; `abx verify` is the from-chain confirmation either way). */
+export declare function expectedChainComplete(deps: ParsedDependencyRef[], checks: DepCheck[]): {
+    expected: boolean | null;
+    detail: string;
+};
+/** The generator this project's on-chain lane actually uses: the collection `animation_url`
+ *  field's `renderer` value when set (that address is what the metadata renderer staticcalls),
+ *  else the chain's canonical generator. Null when neither exists. */
+export declare function generatorFor(state: ProjectState, override?: string): Address | null;
+/** Whether verify should run the on-chain-URI report: the tokenURIRenderer toggle is on, or
+ *  the collection `animation` field points at a field renderer (the generator). */
+export declare function hasOnChainUriLane(state: ProjectState): boolean;
+export interface TokenUriProbe {
+    tokenId: string;
+    /** Which accessor was actually read — `tokenURI` on a 721, `uri` on an ERC-1155 edition. Readouts
+     *  quote this so an edition is never described in 721 terms. */
+    accessor: 'tokenURI' | 'uri';
+    /** tokenURI(id)/uri(id) is a `data:application/json;base64,` URI (resolves on-chain, any RPC). */
+    onChainJson: boolean;
+    uriPrefix: string;
+    animation: {
+        form: 'data-html';
+        bytes: number;
+        marker: string | null;
+    } | {
+        form: 'url';
+        url: string;
+    } | {
+        form: 'data-other';
+        prefix: string;
+    } | {
+        form: 'missing';
+    };
+}
+export interface OnChainUriReport {
+    generator: Address;
+    status: GeneratorStatus;
+    /** Null when no token is minted yet (tokenURI would revert). */
+    probe: TokenUriProbe | null;
+}
+/**
+ * The verify-time on-chain-URI report: `generator.onChainStatus(token)` (branch ·
+ * chain-completeness · unresolved refs · URL budget) plus a `tokenURI` probe of the lowest
+ * minted token — decoded, with the `animation_url` form checked against the branch.
+ */
+export declare function onChainUriReport(client: GeneratorReadClient, state: ProjectState, generatorOverride?: string): Promise<OnChainUriReport>;
+//# sourceMappingURL=onchain-uri.d.ts.map

package/dist/onchain-uri.d.ts.map

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

package/dist/onchain-uri.js

@@ -0,0 +1,276 @@
+/**
+ * The on-chain tokenURI lane for code projects (`abx deploy-code --onchain-uri`) — pure leg
+ * composition + the verify-time honesty reads, all unit-testable with a mocked client.
+ *
+ * The lane (site/content/docs/protocol/code-projects.mdx → "The canonical generator — AbxGenerator" +
+ * site/content/docs/protocol/metadata.mdx → "URI resolution"): the collection-scope `animation_url`
+ * field points at the canonical generator via the `renderer` representation
+ * (`abi.encode(address)`), and the token's `tokenURIRenderer` toggles tokenURI to the canonical
+ * on-chain metadata renderer (`setContractURIRenderer` does the same for contractURI). Both ride
+ * the EXISTING setup multicall, before the mints.
+ *
+ * The param surface is NOT part of that wiring: params enumerate ON-CHAIN (`contractParamKeys` /
+ * `tokenParamKeys`, maintained by the write paths themselves), so the generator reads the key set
+ * straight from the token. The old `params.keys` CSV convention is retired — nothing writes it any
+ * more.
+ */
+import { encodeFunctionData, zeroAddress } from 'viem';
+import { decodeTag, encodeTag, METADATA_FIELD as F, METADATA_REPRESENTATION as R } from './spine.js';
+import { seriesCodeAbi } from './abi/index.js';
+import { readGeneratorStatus } from './generator.js';
+import { resolveGenerator } from './deployments.js';
+import { decodeFieldRenderer, encodeFieldRenderer } from './token.js';
+import { DEP_RESOLUTION } from './deps.js';
+import { parseDataUri, base64ToBytes } from './util.js';
+/**
+ * The `--onchain-uri` legs of the setup multicall, in order:
+ *   1. collection-scope `animation_url` field → representation `renderer`,
+ *      value `abi.encode(generator)` (the canonical generator computes the live view on-chain);
+ *   2. `setTokenURIRenderer(metadataRenderer)` — tokenURI resolves ON-CHAIN from here on;
+ *   3. `setContractURIRenderer(metadataRenderer)` — contractURI too (parity with the 1/1 lane).
+ * Placed BEFORE the mint legs so every token is born with the on-chain lane fully configured.
+ *
+ * There is no param leg: the generator enumerates the param surface from the token itself
+ * (`contractParamKeys` / `tokenParamKeys`), so there is nothing for a deploy to declare.
+ */
+export function onchainUriSetupCalls(args) {
+    const calls = [];
+    // The `animation_url` leg points at the generator (which computes the doc from a PROGRAM). A
+    // renderer-only drop (in-chain SVG, no program) has no generator — and baking this leg at a ZERO
+    // generator would make the metadata renderer staticcall a codeless address and REVERT every
+    // tokenURI. So emit it only when there's a real generator; otherwise there's simply no animation_url
+    // (optional by spec — the metadata renderer omits an unset field).
+    if (args.generator !== zeroAddress) {
+        calls.push(encodeFunctionData({
+            abi: seriesCodeAbi,
+            functionName: 'setContractField',
+            args: [encodeTag(F.animationUrl), encodeTag(R.renderer), encodeFieldRenderer(args.generator)],
+        }));
+    }
+    calls.push(encodeFunctionData({ abi: seriesCodeAbi, functionName: 'setTokenURIRenderer', args: [args.metadataRenderer] }), encodeFunctionData({ abi: seriesCodeAbi, functionName: 'setContractURIRenderer', args: [args.metadataRenderer] }));
+    return calls;
+}
+// ── the param surface, enumerated FROM CHAIN ──────────────────────────────────
+// `key ∈ list ⟺ the param isSet` — the contract maintains both key lists inside the write paths
+// themselves, so nothing off-chain has to be kept in step. `seed` is deliberately never listed
+// (every consumer reads it as a tokenData coordinate). Enumeration order is unspecified; the
+// canonical serialization sorts.
+/** The SET param keys: `contractParamKeys()`, plus `tokenParamKeys(tokenId)` when a token is named.
+ *  Null when the getters are absent — a LEGACY project deployed before enumeration shipped (or a
+ *  token type with no Params extension at all). */
+export async function readSetParamKeys(client, contract, tokenId) {
+    try {
+        const contractKeys = (await client.readContract({
+            address: contract,
+            abi: seriesCodeAbi,
+            functionName: 'contractParamKeys',
+            args: [],
+        }));
+        const tokenKeys = tokenId === undefined
+            ? []
+            : (await client.readContract({
+                address: contract,
+                abi: seriesCodeAbi,
+                functionName: 'tokenParamKeys',
+                args: [tokenId],
+            }));
+        return { contract: contractKeys.map(decodeTag), token: tokenKeys.map(decodeTag) };
+    }
+    catch {
+        return null;
+    }
+}
+/** The DECLARED (governed) keys: `paramSchemaKeys()`, append-only — including keys declared but
+ *  never yet written, which are otherwise undiscoverable. Null on a legacy project. */
+export async function readParamSchemaKeys(client, contract) {
+    try {
+        const keys = (await client.readContract({
+            address: contract,
+            abi: seriesCodeAbi,
+            functionName: 'paramSchemaKeys',
+            args: [],
+        }));
+        return keys.map(decodeTag);
+    }
+    catch {
+        return null;
+    }
+}
+/** The project's three param-lifecycle hook addresses (`paramHooks()`), zeroes included — null on a
+ *  project with no ConfigurableParams surface (a 1/1, a plain Series, an image edition).
+ *
+ *  The `transferHook` in this trio is a **veto**: its revert fails the transfer, and a mint is a
+ *  transfer from `0x0`, so a reverting hook stops minting too. Whether the trio can still change is
+ *  a separate read — `readParamHooksLocked` (ops.ts), or the `ParamHooksFrozen` fold. */
+export async function readParamHooks(client, contract) {
+    try {
+        const [configureHook, augmentHook, transferHook] = (await client.readContract({
+            address: contract,
+            abi: seriesCodeAbi,
+            functionName: 'paramHooks',
+            args: [],
+        }));
+        return { configureHook, augmentHook, transferHook };
+    }
+    catch {
+        return null;
+    }
+}
+/** Does this token expose the enumeration surface at all? The one-call probe behind the repoint
+ *  guard: the canonical generator reads params from chain, so pointing a token that lacks these
+ *  getters at it makes every param silently invisible. */
+export async function hasParamEnumeration(client, contract) {
+    try {
+        await client.readContract({ address: contract, abi: seriesCodeAbi, functionName: 'tokenParamKeys', args: [0n] });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── the chain-complete expectation (deploy-time, from the P1 dependency report) ──
+/** What the deploy can honestly promise about the generator's template branch, derived from
+ *  the selection-time dependency report (never a new RPC): chain-complete iff every registry
+ *  dep has proven ON-CHAIN bytes (OnChain refs read their data contract directly, so they
+ *  count as on-chain; `abx verify` is the from-chain confirmation either way). */
+export function expectedChainComplete(deps, checks) {
+    if (deps.length === 0)
+        return { expected: true, detail: 'no dependencies — the document assembles from the script chunks alone' };
+    const registryDeps = deps.filter((d) => d.resolution === DEP_RESOLUTION.registry);
+    if (registryDeps.length === 0) {
+        return { expected: true, detail: 'all dependencies are on-chain data contracts (read directly)' };
+    }
+    const byDep = new Map(checks.map((c) => [c.dep, c]));
+    const cdnOnly = [];
+    const missing = [];
+    let unknown = false;
+    for (const d of registryDeps) {
+        const chk = byDep.get(d.display);
+        if (!chk || chk.status === 'skipped')
+            unknown = true;
+        else if (chk.status === 'not-found')
+            missing.push(d.display);
+        else if (!chk.details.availableOnChain)
+            cdnOnly.push(d.display);
+    }
+    if (missing.length)
+        return { expected: false, detail: `${missing.join(', ')} not on the registry — the generator will emit an unresolved marker` };
+    if (cdnOnly.length)
+        return { expected: false, detail: `${cdnOnly.join(', ')} CDN-served (the normal production path) — serves fine, NOT chain-complete` };
+    if (unknown)
+        return { expected: null, detail: 'registry check was skipped (RPC unreachable) — `abx verify` reads the truth from chain' };
+    return { expected: true, detail: 'every dependency has ON-CHAIN bytes — no server, gateway, or CDN in the graph' };
+}
+// ── verify: the honesty reads (`onChainStatus` + a tokenURI probe) ─────────────
+/** The generator this project's on-chain lane actually uses: the collection `animation_url`
+ *  field's `renderer` value when set (that address is what the metadata renderer staticcalls),
+ *  else the chain's canonical generator. Null when neither exists. */
+export function generatorFor(state, override) {
+    const field = state.collectionFields.find((f) => f.field === F.animationUrl && f.representation === R.renderer);
+    if (field) {
+        try {
+            return decodeFieldRenderer(field.value);
+        }
+        catch {
+            /* malformed value — fall through to the manifest */
+        }
+    }
+    return resolveGenerator(state.chainId, override) ?? null;
+}
+/** Whether verify should run the on-chain-URI report: the tokenURIRenderer toggle is on, or
+ *  the collection `animation` field points at a field renderer (the generator). */
+export function hasOnChainUriLane(state) {
+    const rendererSet = !!state.tokenURIRenderer && state.tokenURIRenderer !== zeroAddress;
+    const animationRenderer = state.collectionFields.some((f) => f.field === F.animationUrl && f.representation === R.renderer);
+    return rendererSet || animationRenderer;
+}
+const erc721TokenUriAbi = [
+    {
+        type: 'function',
+        name: 'tokenURI',
+        stateMutability: 'view',
+        inputs: [{ name: 'id', type: 'uint256' }],
+        outputs: [{ name: '', type: 'string' }],
+    },
+];
+/** The three ERC-1155 members of the `contractType` ladder — the ones that expose `uri(id)` instead
+ *  of `tokenURI(id)`. Kept as a set so adding a token family is one edit, not a string-shape guess. */
+const EDITION_CONTRACT_TYPES = new Set(['1of1-edition', 'edition', 'edition-code']);
+/** The 1155 twin of the probe above. An edition exposes `uri(id)`, NOT `tokenURI(id)` — probing a
+ *  721 selector on an edition reverts, which surfaced as `verify` reporting "on-chain URI check
+ *  unavailable" (plus a raw viem dump) for EVERY edition. Mirrors `reconstruct.ts`'s uriAbi/uriFn. */
+const erc1155UriAbi = [
+    {
+        type: 'function',
+        name: 'uri',
+        stateMutability: 'view',
+        inputs: [{ name: 'id', type: 'uint256' }],
+        outputs: [{ name: '', type: 'string' }],
+    },
+];
+/** An HTML comment marker the generator emits on degradation (`<!-- abx:… -->`), or null. */
+function degradationMarker(html) {
+    const m = /<!--\s*abx:[^>]*-->/.exec(html);
+    return m ? m[0] : null;
+}
+function probeAnimation(animationUrl) {
+    if (!animationUrl)
+        return { form: 'missing' };
+    const parsed = parseDataUri(animationUrl);
+    if (parsed && parsed.mime === 'text/html' && parsed.base64) {
+        const bytes = base64ToBytes(parsed.body);
+        const html = new TextDecoder().decode(bytes);
+        return { form: 'data-html', bytes: bytes.length, marker: degradationMarker(html) };
+    }
+    if (animationUrl.startsWith('data:'))
+        return { form: 'data-other', prefix: animationUrl.slice(0, 40) };
+    return { form: 'url', url: animationUrl };
+}
+/**
+ * The verify-time on-chain-URI report: `generator.onChainStatus(token)` (branch ·
+ * chain-completeness · unresolved refs · URL budget) plus a `tokenURI` probe of the lowest
+ * minted token — decoded, with the `animation_url` form checked against the branch.
+ */
+export async function onChainUriReport(client, state, generatorOverride) {
+    const generator = generatorFor(state, generatorOverride);
+    if (!generator) {
+        throw new Error(`no AbxGenerator known for chain ${state.chainId} — set ABX_GENERATOR=0x… (or update @artblocks/abx-sdk's deployments manifest)`);
+    }
+    const status = await readGeneratorStatus(client, generator, state.address);
+    // LIVE tokens only, and the reason is sharper than tidiness: this probe reads the LOWEST id it
+    // finds, and `tokenURI` reverts `NonexistentToken` for a burned one. Burned ids must not make the
+    // collection's on-chain-URI lane report as broken.
+    const minted = state.tokens.filter((t) => t.lifecycle === 'live').map((t) => BigInt(t.tokenId));
+    let probe = null;
+    if (minted.length) {
+        const tokenId = minted.reduce((a, b) => (b < a ? b : a));
+        const isEdition = EDITION_CONTRACT_TYPES.has(state.contractType ?? '');
+        const uri = (await client.readContract({
+            address: state.address,
+            abi: isEdition ? erc1155UriAbi : erc721TokenUriAbi,
+            functionName: isEdition ? 'uri' : 'tokenURI',
+            args: [tokenId],
+        }));
+        const parsed = parseDataUri(uri);
+        const isOnChainJson = !!parsed && parsed.mime === 'application/json' && parsed.base64;
+        let animation = { form: 'missing' };
+        if (parsed && isOnChainJson) {
+            try {
+                const json = JSON.parse(new TextDecoder().decode(base64ToBytes(parsed.body)));
+                animation = probeAnimation(typeof json.animation_url === 'string' ? json.animation_url : undefined);
+            }
+            catch {
+                /* undecodable JSON — reported as onChainJson with a missing animation */
+            }
+        }
+        probe = {
+            tokenId: tokenId.toString(),
+            accessor: isEdition ? 'uri' : 'tokenURI',
+            onChainJson: isOnChainJson,
+            uriPrefix: uri.slice(0, 48),
+            animation,
+        };
+    }
+    return { generator, status, probe };
+}
+//# sourceMappingURL=onchain-uri.js.map

package/dist/onchain-uri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onchain-uri.js","sourceRoot":"","sources":["../src/onchain-uri.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAC,kBAAkB,EAAE,WAAW,EAAyB,MAAM,MAAM,CAAC;AAC7E,OAAO,EAAC,SAAS,EAAE,SAAS,EAAE,cAAc,IAAI,CAAC,EAAE,uBAAuB,IAAI,CAAC,EAAC,MAAM,YAAY,CAAC;AACnG,OAAO,EAAC,aAAa,EAAC,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAC,mBAAmB,EAAiD,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAC,gBAAgB,EAAC,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAC,mBAAmB,EAAE,mBAAmB,EAAC,MAAM,YAAY,CAAC;AACpE,OAAO,EAAC,cAAc,EAA0C,MAAM,WAAW,CAAC;AAElF,OAAO,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,WAAW,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAqD;IACxF,MAAM,KAAK,GAAU,EAAE,CAAC;IACxB,6FAA6F;IAC7F,iGAAiG;IACjG,4FAA4F;IAC5F,qGAAqG;IACrG,mEAAmE;IACnE,IAAI,IAAI,CAAC,SAAS,KAAK,WAAW,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CACR,kBAAkB,CAAC;YACjB,GAAG,EAAE,aAAa;YAClB,YAAY,EAAE,kBAAkB;YAChC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;SAC9F,CAAC,CACH,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CACR,kBAAkB,CAAC,EAAC,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAC,CAAC,EAC5G,kBAAkB,CAAC,EAAC,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,wBAAwB,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAC,CAAC,CAChH,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iFAAiF;AACjF,gGAAgG;AAChG,+FAA+F;AAC/F,6FAA6F;AAC7F,iCAAiC;AAEjC;;mDAEmD;AACnD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA2B,EAC3B,QAAiB,EACjB,OAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC;YAC9C,OAAO,EAAE,QAAQ;YACjB,GAAG,EAAE,aAAa;YAClB,YAAY,EAAE,mBAAmB;YACjC,IAAI,EAAE,EAAE;SACT,CAAC,CAAmB,CAAC;QACtB,MAAM,SAAS,GACb,OAAO,KAAK,SAAS;YACnB,CAAC,CAAE,EAAqB;YACxB,CAAC,CAAE,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC;gBAC1B,OAAO,EAAE,QAAQ;gBACjB,GAAG,EAAE,aAAa;gBAClB,YAAY,EAAE,gBAAgB;gBAC9B,IAAI,EAAE,CAAC,OAAO,CAAC;aAChB,CAAC,CAAoB,CAAC;QAC7B,OAAO,EAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAC,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;uFACuF;AACvF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAA2B,EAAE,QAAiB;IACtF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC;YACtC,OAAO,EAAE,QAAQ;YACjB,GAAG,EAAE,aAAa;YAClB,YAAY,EAAE,iBAAiB;YAC/B,IAAI,EAAE,EAAE;SACT,CAAC,CAAmB,CAAC;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;yFAKyF;AACzF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA2B,EAC3B,QAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,CAAC,aAAa,EAAE,WAAW,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC;YAC5E,OAAO,EAAE,QAAQ;YACjB,GAAG,EAAE,aAAa;YAClB,YAAY,EAAE,YAAY;YAC1B,IAAI,EAAE,EAAE;SACT,CAAC,CAAyC,CAAC;QAC5C,OAAO,EAAC,aAAa,EAAE,WAAW,EAAE,YAAY,EAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;0DAE0D;AAC1D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAA2B,EAAE,QAAiB;IACtF,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,EAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAC,CAAC,CAAC;QAC/G,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,oFAAoF;AAEpF;;;kFAGkF;AAClF,MAAM,UAAU,qBAAqB,CACnC,IAA2B,EAC3B,MAAkB;IAElB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,uEAAuE,EAAC,CAAC;IAChI,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,cAAc,CAAC,QAAQ,CAAC,CAAC;IAClF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,8DAA8D,EAAC,CAAC;IAClG,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,GAAG,IAAI,CAAC;aAChD,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;aACxD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,EAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,qEAAqE,EAAC,CAAC;IACjJ,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,EAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,4EAA4E,EAAC,CAAC;IACxJ,IAAI,OAAO;QAAE,OAAO,EAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,wFAAwF,EAAC,CAAC;IACvI,OAAO,EAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,+EAA+E,EAAC,CAAC;AACnH,CAAC;AAED,kFAAkF;AAElF;;sEAEsE;AACtE,MAAM,UAAU,YAAY,CAAC,KAAmB,EAAE,QAAiB;IACjE,MAAM,KAAK,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,cAAc,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC;IAChH,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC;YACH,OAAO,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;IACH,CAAC;IACD,OAAO,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC;AAC3D,CAAC;AAED;mFACmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,gBAAgB,KAAK,WAAW,CAAC;IACvF,MAAM,iBAAiB,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,CACnD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,cAAc,KAAK,CAAC,CAAC,QAAQ,CACrE,CAAC;IACF,OAAO,WAAW,IAAI,iBAAiB,CAAC;AAC1C,CAAC;AAED,MAAM,iBAAiB,GAAG;IACxB;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAC,CAAC;QACvC,OAAO,EAAE,CAAC,EAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAC,CAAC;KACtC;CACO,CAAC;AAEX;uGACuG;AACvG,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;AAEzG;;sGAEsG;AACtG,MAAM,aAAa,GAAG;IACpB;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,KAAK;QACX,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAC,CAAC;QACvC,OAAO,EAAE,CAAC,EAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAC,CAAC;KACtC;CACO,CAAC;AAwBX,6FAA6F;AAC7F,SAAS,iBAAiB,CAAC,IAAY;IACrC,MAAM,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzB,CAAC;AAED,SAAS,cAAc,CAAC,YAAgC;IACtD,IAAI,CAAC,YAAY;QAAE,OAAO,EAAC,IAAI,EAAE,SAAS,EAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7C,OAAO,EAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAC,CAAC;IACnF,CAAC;IACD,IAAI,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAC,CAAC;IACrG,OAAO,EAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA2B,EAC3B,KAAmB,EACnB,iBAA0B;IAE1B,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACzD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,mCAAmC,KAAK,CAAC,OAAO,gFAAgF,CACjI,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAE3E,+FAA+F;IAC/F,kGAAkG;IAClG,mDAAmD;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAChG,IAAI,KAAK,GAAyB,IAAI,CAAC;IACvC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QACvE,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC;YACrC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,iBAAiB;YAClD,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU;YAC5C,IAAI,EAAE,CAAC,OAAO,CAAC;SAChB,CAAC,CAAW,CAAC;QACd,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,IAAI,MAAM,CAAC,MAAM,CAAC;QACtF,IAAI,SAAS,GAA+B,EAAC,IAAI,EAAE,SAAS,EAAC,CAAC;QAC9D,IAAI,MAAM,IAAI,aAAa,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAA4B,CAAC;gBACzG,SAAS,GAAG,cAAc,CAAC,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACtG,CAAC;YAAC,MAAM,CAAC;gBACP,yEAAyE;YAC3E,CAAC;QACH,CAAC;QACD,KAAK,GAAG;YACN,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE;YAC3B,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU;YACxC,WAAW,EAAE,aAAa;YAC1B,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAC3B,SAAS;SACV,CAAC;IACJ,CAAC;IACD,OAAO,EAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAC,CAAC;AACpC,CAAC"}