figma-inspect-cli 0.1.0

package/dist/inspect/contract/contract-lock.js

@@ -0,0 +1,326 @@
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { parse } from "yaml";
+import { FigmaInspectError } from "../errors.js";
+import { serializeContractData } from "./contract-format.js";
+import { defaultLockApproval, defaultLockDrift, hasContractSurfaceFingerprint, normalizeLockVersion, normalizeVersionedLockMetadata, } from "./lock-metadata.js";
+function contractLockFileName(componentName) {
+    return `${componentName}.component-set.lock.yaml`;
+}
+export function resolveContractLockPath(directory, componentName) {
+    return path.join(directory, contractLockFileName(componentName));
+}
+function sortVariants(variants) {
+    return [...variants].sort((left, right) => left.name.localeCompare(right.name));
+}
+function sameSourceIdentity(left, right) {
+    return (left.fileKey === right.fileKey &&
+        left.nodeId === right.nodeId &&
+        (left.nodeType ?? "COMPONENT_SET") ===
+            (right.nodeType ?? "COMPONENT_SET") &&
+        left.componentSetKey === right.componentSetKey);
+}
+function sameVariantIdentity(left, right) {
+    return (left.key === right.key &&
+        left.nodeId === right.nodeId &&
+        left.name === right.name);
+}
+export function buildContractLock(input) {
+    return {
+        version: 2,
+        kind: "component-set",
+        source: { ...input.source, nodeType: "COMPONENT_SET" },
+        variants: sortVariants(input.variants),
+        fingerprints: {
+            ...input.fingerprints,
+            ...(input.fingerprints.assets
+                ? {
+                    assets: Object.fromEntries(Object.entries(input.fingerprints.assets).sort(([left], [right]) => left.localeCompare(right))),
+                }
+                : {}),
+        },
+        approval: defaultLockApproval(),
+        drift: defaultLockDrift(),
+    };
+}
+export async function readContractLock(lockPath) {
+    let raw;
+    try {
+        raw = await readFile(lockPath, "utf8");
+    }
+    catch (error) {
+        if (typeof error === "object" &&
+            error !== null &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+    const parsed = parse(raw);
+    const lock = normalizeContractLock(parsed);
+    if (!lock) {
+        throw new FigmaInspectError(`Invalid contract lock file: ${lockPath}`);
+    }
+    return lock;
+}
+function readRecordField(value, camelKey, snakeKey) {
+    if (typeof value !== "object" || value === null) {
+        return undefined;
+    }
+    const record = value;
+    return record[camelKey] ?? record[snakeKey];
+}
+function readStringField(value, camelKey, snakeKey) {
+    const field = readRecordField(value, camelKey, snakeKey);
+    return typeof field === "string" ? field : undefined;
+}
+function normalizeContractLockVariant(value) {
+    const key = readStringField(value, "key", "key");
+    const nodeId = readStringField(value, "nodeId", "node_id");
+    const name = readStringField(value, "name", "name");
+    const updatedAt = readStringField(value, "updatedAt", "updated_at");
+    if (!key || !nodeId || !name || !updatedAt) {
+        return undefined;
+    }
+    return { key, nodeId, name, updatedAt };
+}
+function normalizeContractLockSource(value) {
+    const fileKey = readStringField(value, "fileKey", "file_key");
+    const nodeId = readStringField(value, "nodeId", "node_id");
+    const nodeType = readStringField(value, "nodeType", "node_type");
+    const sourceUrl = readStringField(value, "sourceUrl", "source_url");
+    const componentSetKey = readStringField(value, "componentSetKey", "component_set_key");
+    const componentSetUpdatedAt = readStringField(value, "componentSetUpdatedAt", "component_set_updated_at");
+    if (!fileKey || !nodeId || !componentSetKey || !componentSetUpdatedAt) {
+        return undefined;
+    }
+    return {
+        fileKey,
+        nodeId,
+        ...(nodeType === "COMPONENT_SET" ? { nodeType } : {}),
+        ...(sourceUrl ? { sourceUrl } : {}),
+        componentSetKey,
+        componentSetUpdatedAt,
+    };
+}
+function normalizeContractLock(value) {
+    if (typeof value !== "object" || value === null) {
+        return undefined;
+    }
+    const record = value;
+    const version = normalizeLockVersion(record);
+    if (!version) {
+        return undefined;
+    }
+    if (version === 2 &&
+        (record.kind !== "component-set" ||
+            normalizeContractLockSource(record.source)?.nodeType !== "COMPONENT_SET")) {
+        return undefined;
+    }
+    const source = normalizeContractLockSource(record.source);
+    if (!source) {
+        return undefined;
+    }
+    if (!Array.isArray(record.variants)) {
+        return undefined;
+    }
+    const variants = record.variants
+        .map((variant) => normalizeContractLockVariant(variant))
+        .filter((variant) => variant !== undefined);
+    if (variants.length !== record.variants.length) {
+        return undefined;
+    }
+    const fingerprints = record.fingerprints;
+    if (typeof fingerprints !== "object" || fingerprints === null) {
+        return undefined;
+    }
+    const fingerprintRecord = fingerprints;
+    const tree = fingerprintRecord.tree;
+    const contractSurface = fingerprintRecord.contractSurface;
+    const contracts = fingerprintRecord.contracts;
+    if (typeof tree !== "string" || typeof contracts !== "string") {
+        return undefined;
+    }
+    if (version === 2 && typeof contractSurface !== "string") {
+        return undefined;
+    }
+    const assets = fingerprintRecord.assets;
+    let normalizedAssets;
+    if (assets !== undefined) {
+        if (typeof assets !== "object" || assets === null) {
+            return undefined;
+        }
+        normalizedAssets = {};
+        for (const [assetKey, hash] of Object.entries(assets)) {
+            if (typeof hash !== "string") {
+                return undefined;
+            }
+            normalizedAssets[assetKey] = hash;
+        }
+    }
+    const metadata = normalizeVersionedLockMetadata(record, version);
+    if (!metadata) {
+        return undefined;
+    }
+    const base = {
+        kind: "component-set",
+        variants,
+        approval: metadata.approval,
+        drift: metadata.drift,
+    };
+    if (version === 2) {
+        if (typeof contractSurface !== "string") {
+            return undefined;
+        }
+        return {
+            ...base,
+            version,
+            source: { ...source, nodeType: "COMPONENT_SET" },
+            fingerprints: {
+                tree,
+                contractSurface,
+                contracts,
+                ...(normalizedAssets ? { assets: normalizedAssets } : {}),
+            },
+        };
+    }
+    return {
+        ...base,
+        version,
+        source,
+        fingerprints: {
+            tree,
+            contracts,
+            ...(normalizedAssets ? { assets: normalizedAssets } : {}),
+        },
+    };
+}
+export function toLockVariants(components) {
+    return components.map((component) => ({
+        key: component.key,
+        nodeId: component.node_id,
+        name: component.name,
+        updatedAt: component.updated_at,
+    }));
+}
+function sameContractSurface(lock, live) {
+    if (hasContractSurfaceFingerprint(lock.fingerprints) &&
+        live.contractSurfaceFingerprint) {
+        return (lock.fingerprints.contractSurface === live.contractSurfaceFingerprint);
+    }
+    return lock.fingerprints.tree === live.treeFingerprint;
+}
+export function diffContractLock(lock, live) {
+    const lockedByNodeId = new Map(lock.variants.map((variant) => [variant.nodeId, variant]));
+    const liveByNodeId = new Map(live.variants.map((variant) => [variant.nodeId, variant]));
+    const changedVariants = [];
+    const addedVariants = [];
+    const removedVariants = [];
+    for (const liveVariant of live.variants) {
+        const locked = lockedByNodeId.get(liveVariant.nodeId);
+        if (!locked) {
+            addedVariants.push(liveVariant.name);
+            continue;
+        }
+        if (!sameVariantIdentity(locked, liveVariant)) {
+            changedVariants.push(liveVariant.name);
+        }
+    }
+    for (const lockedVariant of lock.variants) {
+        if (!liveByNodeId.has(lockedVariant.nodeId)) {
+            removedVariants.push(lockedVariant.name);
+        }
+    }
+    return {
+        source: !sameSourceIdentity(lock.source, live.source),
+        tree: !hasContractSurfaceFingerprint(lock.fingerprints) &&
+            lock.fingerprints.tree !== live.treeFingerprint,
+        contractSurface: !sameContractSurface(lock, live),
+        variants: changedVariants.sort((left, right) => left.localeCompare(right)),
+        addedVariants: addedVariants.sort((left, right) => left.localeCompare(right)),
+        removedVariants: removedVariants.sort((left, right) => left.localeCompare(right)),
+    };
+}
+export function isContractLockDiffEmpty(diff) {
+    return (!diff.source &&
+        !diff.tree &&
+        !diff.contractSurface &&
+        diff.variants.length === 0 &&
+        diff.addedVariants.length === 0 &&
+        diff.removedVariants.length === 0);
+}
+export async function writeContractLock(lockPath, lock) {
+    await writeFile(lockPath, serializeContractData(lock, "yaml"), "utf8");
+}
+export function collectUnchangedVariantNodeIds(previousLock, variants, currentTreeFingerprint, currentContractSurfaceFingerprint) {
+    const unchanged = new Set();
+    if (!previousLock) {
+        return unchanged;
+    }
+    const previousByNodeId = new Map(previousLock.variants.map((variant) => [variant.nodeId, variant]));
+    const treeIsUnchanged = currentTreeFingerprint !== undefined &&
+        previousLock.fingerprints.tree === currentTreeFingerprint;
+    const contractSurfaceIsUnchanged = currentContractSurfaceFingerprint !== undefined &&
+        hasContractSurfaceFingerprint(previousLock.fingerprints) &&
+        previousLock.fingerprints.contractSurface ===
+            currentContractSurfaceFingerprint;
+    const sourceSurfaceIsUnchanged = hasContractSurfaceFingerprint(previousLock.fingerprints)
+        ? contractSurfaceIsUnchanged
+        : treeIsUnchanged;
+    for (const variant of variants) {
+        const previous = previousByNodeId.get(variant.nodeId);
+        if (!previous) {
+            continue;
+        }
+        if (sourceSurfaceIsUnchanged && sameVariantIdentity(previous, variant)) {
+            unchanged.add(variant.nodeId);
+            continue;
+        }
+        if (previous.updatedAt === variant.updatedAt) {
+            unchanged.add(variant.nodeId);
+        }
+    }
+    return unchanged;
+}
+export function stabilizeContractLockDates(previousLock, lock) {
+    const sourceSurfaceIsUnchanged = previousLock &&
+        hasContractSurfaceFingerprint(previousLock.fingerprints) &&
+        hasContractSurfaceFingerprint(lock.fingerprints)
+        ? previousLock.fingerprints.contractSurface ===
+            lock.fingerprints.contractSurface
+        : previousLock?.fingerprints.tree === lock.fingerprints.tree;
+    if (!previousLock || !sourceSurfaceIsUnchanged) {
+        return lock;
+    }
+    const previousByNodeId = new Map(previousLock.variants.map((variant) => [variant.nodeId, variant]));
+    const source = sameSourceIdentity(previousLock.source, lock.source)
+        ? {
+            ...lock.source,
+            componentSetUpdatedAt: previousLock.source.componentSetUpdatedAt,
+        }
+        : lock.source;
+    const variants = lock.variants.map((variant) => {
+        const previous = previousByNodeId.get(variant.nodeId);
+        if (!previous || !sameVariantIdentity(previous, variant)) {
+            return variant;
+        }
+        return {
+            ...variant,
+            updatedAt: previous.updatedAt,
+        };
+    });
+    if (lock.version === 2) {
+        return {
+            ...lock,
+            source: { ...source, nodeType: "COMPONENT_SET" },
+            variants,
+        };
+    }
+    return {
+        ...lock,
+        source,
+        variants,
+    };
+}
+//# sourceMappingURL=contract-lock.js.map

package/dist/inspect/contract/contract-lock.js.map

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

package/dist/inspect/contract/contract-schema.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import type { AssetContractMap } from "../component-set-pseudocode/assets-contract.js";
+import { type ContractFormat } from "./contract-format.js";
+declare const metaContractSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    component: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        key: z.ZodString;
+        name: z.ZodString;
+        fileKey: z.ZodString;
+        projectId: z.ZodString;
+    }, z.core.$strip>>;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            boolean: "boolean";
+            text: "text";
+            instance: "instance";
+            variant: "variant";
+        }>;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    slots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        kind: z.ZodEnum<{
+            swap: "swap";
+            nested: "nested";
+        }>;
+        component: z.ZodString;
+    }, z.core.$strip>>>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        key: z.ZodString;
+        name: z.ZodString;
+        fileKey: z.ZodString;
+        projectId: z.ZodString;
+    }, z.core.$strip>>>;
+    assets: z.ZodOptional<z.ZodType<AssetContractMap, unknown, z.core.$ZodTypeInternals<AssetContractMap, unknown>>>;
+}, z.core.$strip>;
+type MetaContractValidated = z.infer<typeof metaContractSchema>;
+export interface ComponentContractArtifacts {
+    componentName: string;
+    meta: MetaContractValidated;
+    geometry: Record<string, unknown>;
+    visuals: Record<string, unknown>;
+    structureDsl: string;
+    assetsDir?: string;
+}
+export declare function readComponentContractArtifacts(contractDir: string, componentName: string, format?: ContractFormat): Promise<ComponentContractArtifacts>;
+export declare function validateComponentContractArtifacts(artifacts: ComponentContractArtifacts, format?: ContractFormat): void;
+export {};
+//# sourceMappingURL=contract-schema.d.ts.map

package/dist/inspect/contract/contract-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-schema.d.ts","sourceRoot":"","sources":["../../../src/inspect/contract/contract-schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAMvF,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,sBAAsB,CAAC;AA8B9B,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOtB,CAAC;AAEH,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAYhE,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiGD,wBAAsB,8BAA8B,CAClD,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,cAAuB,GAC9B,OAAO,CAAC,0BAA0B,CAAC,CAoDrC;AAED,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,0BAA0B,EACrC,MAAM,GAAE,cAAuB,GAC9B,IAAI,CASN"}

package/dist/inspect/contract/contract-schema.js

@@ -0,0 +1,130 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse } from "yaml";
+import { z } from "zod";
+import { resolveMetaContractPath, resolveStructureDslPath, } from "../component-set-pseudocode/build-pseudocode.js";
+import { FigmaInspectError } from "../errors.js";
+import { contractArtifactFileName, } from "./contract-format.js";
+const teamComponentEntrySchema = z.object({
+    id: z.string().min(1),
+    key: z.string().min(1),
+    name: z.string().min(1),
+    fileKey: z.string().min(1),
+    projectId: z.string(),
+});
+const metaPropSchema = z.object({
+    type: z.enum(["boolean", "instance", "text", "variant"]),
+    default: z.union([z.boolean(), z.string()]).optional(),
+    options: z.array(z.string()).optional(),
+});
+const metaSlotSchema = z.object({
+    kind: z.enum(["swap", "nested"]),
+    component: z.string().min(1),
+});
+const assetEntrySchema = z.object({
+    path: z.string().min(1),
+    format: z.literal("svg"),
+});
+const assetContractMapSchema = z.lazy(() => z.record(z.string(), z.union([assetEntrySchema, assetContractMapSchema])));
+const metaContractSchema = z.object({
+    version: z.literal(1),
+    component: teamComponentEntrySchema.optional(),
+    props: z.record(z.string(), metaPropSchema).optional(),
+    slots: z.record(z.string(), metaSlotSchema).optional(),
+    dependencies: z.array(teamComponentEntrySchema).optional(),
+    assets: assetContractMapSchema.optional(),
+});
+const variantTreeSchema = z.lazy(() => z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), variantTreeSchema])));
+const geometryContractSchema = variantTreeSchema;
+const visualsContractSchema = variantTreeSchema;
+function formatSchemaIssues(error) {
+    return error.issues.map((issue) => {
+        const pathLabel = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+        return `${pathLabel}: ${issue.message}`;
+    });
+}
+function parseRecord(raw, label, format) {
+    if (format === "json") {
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            throw new FigmaInspectError(`Invalid JSON in ${label}.`);
+        }
+        if (typeof parsed !== "object" ||
+            parsed === null ||
+            Array.isArray(parsed)) {
+            throw new FigmaInspectError(`${label} must be a JSON object.`);
+        }
+        return parsed;
+    }
+    return parseYamlRecord(raw, label);
+}
+function parseYamlRecord(raw, label) {
+    const parsed = parse(raw);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new FigmaInspectError(`${label} must be a YAML mapping.`);
+    }
+    return parsed;
+}
+function validateRecord(schema, value, label) {
+    const result = schema.safeParse(value);
+    if (!result.success) {
+        throw new FigmaInspectError(`Invalid ${label}:\n${formatSchemaIssues(result.error).join("\n")}`);
+    }
+    return result.data;
+}
+function validateStructureDsl(structureDsl, componentName, format) {
+    const lines = structureDsl.split("\n");
+    const header = lines[0]?.trim();
+    if (header !== `component ${componentName}`) {
+        throw new FigmaInspectError(`Invalid structure DSL: expected first line "component ${componentName}".`);
+    }
+    const requiredSnippets = [
+        "contracts {",
+        contractArtifactFileName(componentName, "visuals", format),
+        contractArtifactFileName(componentName, "geometry", format),
+        contractArtifactFileName(componentName, "meta", format),
+        "resolve {",
+        "templates {",
+    ];
+    for (const snippet of requiredSnippets) {
+        if (!structureDsl.includes(snippet)) {
+            throw new FigmaInspectError(`Invalid structure DSL: missing ${JSON.stringify(snippet)}.`);
+        }
+    }
+    if (structureDsl.includes(".component-set.assets.")) {
+        throw new FigmaInspectError("Invalid structure DSL: assets must live in meta.yaml, not a separate assets file.");
+    }
+}
+export async function readComponentContractArtifacts(contractDir, componentName, format = "yaml") {
+    const [metaRaw, geometryRaw, visualsRaw, structureDsl] = await Promise.all([
+        readFile(resolveMetaContractPath(contractDir, componentName, format), "utf8"),
+        readFile(path.join(contractDir, contractArtifactFileName(componentName, "geometry", format)), "utf8"),
+        readFile(path.join(contractDir, contractArtifactFileName(componentName, "visuals", format)), "utf8"),
+        readFile(resolveStructureDslPath(contractDir, componentName), "utf8"),
+    ]);
+    const meta = validateRecord(metaContractSchema, parseRecord(metaRaw, "meta contract", format), "meta contract");
+    const geometry = validateRecord(geometryContractSchema, parseRecord(geometryRaw, "geometry contract", format), "geometry contract");
+    const visuals = validateRecord(visualsContractSchema, parseRecord(visualsRaw, "visuals contract", format), "visuals contract");
+    validateStructureDsl(structureDsl, componentName, format);
+    const assetsDir = meta.assets
+        ? path.join(contractDir, `${componentName}.assets`)
+        : undefined;
+    return {
+        componentName,
+        meta,
+        geometry,
+        visuals,
+        structureDsl,
+        assetsDir,
+    };
+}
+export function validateComponentContractArtifacts(artifacts, format = "yaml") {
+    validateRecord(metaContractSchema, artifacts.meta, "meta contract");
+    validateRecord(geometryContractSchema, artifacts.geometry, "geometry contract");
+    validateRecord(visualsContractSchema, artifacts.visuals, "visuals contract");
+    validateStructureDsl(artifacts.structureDsl, artifacts.componentName, format);
+}
+//# sourceMappingURL=contract-schema.js.map

package/dist/inspect/contract/contract-schema.js.map

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

package/dist/inspect/contract/fingerprint.d.ts

@@ -0,0 +1,9 @@
+import type { TeamComponentRegistry } from "../component-set-spec/team-component-registry.js";
+import type { VariableRegistry } from "../component-set-spec/variable-registry.js";
+import type { DocumentNode } from "../schemas.js";
+export declare function fingerprintTree(tree: DocumentNode): string;
+export declare function fingerprintContractSurface(tree: DocumentNode, variables?: VariableRegistry, teamComponents?: TeamComponentRegistry): string;
+export declare function fingerprintContracts(visuals: Record<string, unknown>, geometry: Record<string, unknown>, meta: unknown, structureDsl: string): string;
+export declare function variantAssetSlug(when: Record<string, string>, variantAxes: Record<string, string[]>): string;
+export declare function fingerprintAssetFiles(assetsDir: string, slugs: string[]): Promise<Record<string, string>>;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/inspect/contract/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../../src/inspect/contract/fingerprint.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kDAAkD,CAAC;AAC9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAOlD,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAE1D;AA0WD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,YAAY,EAClB,SAAS,CAAC,EAAE,gBAAgB,EAC5B,cAAc,CAAC,EAAE,qBAAqB,GACrC,MAAM,CAIR;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,MAAM,GACnB,MAAM,CASR;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACpC,MAAM,CAgBR;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAUjC"}