@openzeppelin/upgrades-core 1.9.1

package/dist/storage/extract.js.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,8 @@
+export * from './compat';
+import { StorageLayout } from './layout';
+import { StorageOperation, StorageItem } from './compare';
+import { ValidationOptions } from '../validate/overrides';
+export declare function assertStorageUpgradeSafe(original: StorageLayout, updated: StorageLayout, unsafeAllowCustomTypes: boolean): void;
+export declare function assertStorageUpgradeSafe(original: StorageLayout, updated: StorageLayout, opts: Required<ValidationOptions>): void;
+export declare function getStorageUpgradeErrors(original: StorageLayout, updated: StorageLayout, opts?: ValidationOptions): StorageOperation<StorageItem>[];
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAqB,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAA2B,MAAM,WAAW,CAAC;AAEnF,OAAO,EAAE,iBAAiB,EAA0B,MAAM,uBAAuB,CAAC;AAGlF,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,aAAa,EACtB,sBAAsB,EAAE,OAAO,GAC9B,IAAI,CAAC;AAER,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAChC,IAAI,CAAC;AAsCR,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE,iBAAsB,GAC3B,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAWjC"}

package/dist/storage/index.js

@@ -0,0 +1,65 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStorageUpgradeErrors = exports.assertStorageUpgradeSafe = void 0;
+__exportStar(require("./compat"), exports);
+const error_1 = require("../error");
+const layout_1 = require("./layout");
+const compare_1 = require("./compare");
+const overrides_1 = require("../validate/overrides");
+const log_1 = require("../utils/log");
+function assertStorageUpgradeSafe(original, updated, opts = false) {
+    if (typeof opts === 'boolean') {
+        const unsafeAllowCustomTypes = opts;
+        opts = overrides_1.withValidationDefaults({ unsafeAllowCustomTypes });
+    }
+    const originalDetailed = layout_1.getDetailedLayout(original);
+    const updatedDetailed = layout_1.getDetailedLayout(updated);
+    const comparator = new compare_1.StorageLayoutComparator(opts.unsafeAllowCustomTypes, opts.unsafeAllowRenames);
+    const report = comparator.compareLayouts(originalDetailed, updatedDetailed);
+    if (comparator.hasAllowedUncheckedCustomTypes) {
+        log_1.logWarning(`Potentially unsafe deployment`, [
+            `You are using \`unsafeAllowCustomTypes\` to force approve structs or enums with missing data.`,
+            `Make sure you have manually checked the storage layout for incompatibilities.`,
+        ]);
+    }
+    else if (opts.unsafeAllowCustomTypes) {
+        log_1.logNote(`\`unsafeAllowCustomTypes\` is no longer necessary. Structs are enums are automatically checked.\n`);
+    }
+    if (!report.pass) {
+        throw new StorageUpgradeErrors(report);
+    }
+}
+exports.assertStorageUpgradeSafe = assertStorageUpgradeSafe;
+class StorageUpgradeErrors extends error_1.UpgradesError {
+    constructor(report) {
+        super(`New storage layout is incompatible`, () => report.explain());
+        this.report = report;
+    }
+}
+// Kept for backwards compatibility and to avoid rewriting tests
+function getStorageUpgradeErrors(original, updated, opts = {}) {
+    try {
+        assertStorageUpgradeSafe(original, updated, overrides_1.withValidationDefaults(opts));
+    }
+    catch (e) {
+        if (e instanceof StorageUpgradeErrors) {
+            return e.report.ops;
+        }
+        else {
+            throw e;
+        }
+    }
+    return [];
+}
+exports.getStorageUpgradeErrors = getStorageUpgradeErrors;
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAyB;AAEzB,oCAAyC;AACzC,qCAA4D;AAC5D,uCAAmF;AAEnF,qDAAkF;AAClF,sCAAmD;AAcnD,SAAgB,wBAAwB,CACtC,QAAuB,EACvB,OAAsB,EACtB,OAA8C,KAAK;IAEnD,IAAI,OAAO,IAAI,KAAK,SAAS,EAAE;QAC7B,MAAM,sBAAsB,GAAG,IAAI,CAAC;QACpC,IAAI,GAAG,kCAAsB,CAAC,EAAE,sBAAsB,EAAE,CAAC,CAAC;KAC3D;IAED,MAAM,gBAAgB,GAAG,0BAAiB,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,0BAAiB,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,iCAAuB,CAAC,IAAI,CAAC,sBAAsB,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACrG,MAAM,MAAM,GAAG,UAAU,CAAC,cAAc,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;IAE5E,IAAI,UAAU,CAAC,8BAA8B,EAAE;QAC7C,gBAAU,CAAC,+BAA+B,EAAE;YAC1C,+FAA+F;YAC/F,+EAA+E;SAChF,CAAC,CAAC;KACJ;SAAM,IAAI,IAAI,CAAC,sBAAsB,EAAE;QACtC,aAAO,CAAC,mGAAmG,CAAC,CAAC;KAC9G;IAED,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;QAChB,MAAM,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC;KACxC;AACH,CAAC;AA3BD,4DA2BC;AAED,MAAM,oBAAqB,SAAQ,qBAAa;IAC9C,YAAqB,MAAiC;QACpD,KAAK,CAAC,oCAAoC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QADjD,WAAM,GAAN,MAAM,CAA2B;IAEtD,CAAC;CACF;AAED,gEAAgE;AAChE,SAAgB,uBAAuB,CACrC,QAAuB,EACvB,OAAsB,EACtB,OAA0B,EAAE;IAE5B,IAAI;QACF,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,kCAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;KAC3E;IAAC,OAAO,CAAC,EAAE;QACV,IAAI,CAAC,YAAY,oBAAoB,EAAE;YACrC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACrB;aAAM;YACL,MAAM,CAAC,CAAC;SACT;KACF;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAfD,0DAeC"}

package/dist/storage/layout.d.ts

@@ -0,0 +1,31 @@
+import { ParsedTypeId } from '../utils/parse-type-id';
+export interface StorageLayout {
+    layoutVersion?: string;
+    storage: StorageItem[];
+    types: Record<string, TypeItem>;
+}
+export interface StorageItem<Type = string> {
+    contract: string;
+    label: string;
+    type: Type;
+    src: string;
+}
+export interface TypeItem<Type = string> {
+    label: string;
+    members?: TypeItemMembers<Type>;
+}
+export declare type TypeItemMembers<Type = string> = StructMember<Type>[] | EnumMember[];
+export interface StructMember<Type = string> {
+    label: string;
+    type: Type;
+}
+export declare type EnumMember = string;
+export interface ParsedTypeDetailed extends ParsedTypeId {
+    item: TypeItem<ParsedTypeDetailed>;
+    args?: ParsedTypeDetailed[];
+    rets?: ParsedTypeDetailed[];
+}
+export declare function getDetailedLayout(layout: StorageLayout): StorageItem<ParsedTypeDetailed>[];
+export declare function isEnumMembers<T>(members: TypeItemMembers<T>): members is EnumMember[];
+export declare function isStructMembers<T>(members: TypeItemMembers<T>): members is StructMember<T>[];
+//# sourceMappingURL=layout.d.ts.map

package/dist/storage/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/storage/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAOnE,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,WAAW,CAAC,IAAI,GAAG,MAAM;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,QAAQ,CAAC,IAAI,GAAG,MAAM;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,oBAAY,eAAe,CAAC,IAAI,GAAG,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;AAEjF,MAAM,WAAW,YAAY,CAAC,IAAI,GAAG,MAAM;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,oBAAY,UAAU,GAAG,MAAM,CAAC;AAEhC,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAID,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CAAC,kBAAkB,CAAC,EAAE,CAqC1F;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,UAAU,EAAE,CAErF;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAE5F"}

package/dist/storage/layout.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isStructMembers = exports.isEnumMembers = exports.getDetailedLayout = void 0;
+const parse_type_id_1 = require("../utils/parse-type-id");
+function getDetailedLayout(layout) {
+    const cache = {};
+    return layout.storage.map(parseWithDetails);
+    function parseWithDetails(item) {
+        const parsed = parse_type_id_1.parseTypeId(item.type);
+        const withDetails = addDetailsToParsedType(parsed);
+        return { ...item, type: withDetails };
+    }
+    function addDetailsToParsedType(parsed) {
+        var _a, _b;
+        if (parsed.id in cache) {
+            return cache[parsed.id];
+        }
+        const item = layout.types[parsed.id];
+        const detailed = {
+            ...parsed,
+            args: undefined,
+            rets: undefined,
+            item: {
+                ...item,
+                members: undefined,
+            },
+        };
+        // store in cache before recursion below
+        cache[parsed.id] = detailed;
+        detailed.args = (_a = parsed.args) === null || _a === void 0 ? void 0 : _a.map(addDetailsToParsedType);
+        detailed.rets = (_b = parsed.args) === null || _b === void 0 ? void 0 : _b.map(addDetailsToParsedType);
+        detailed.item.members =
+            (item === null || item === void 0 ? void 0 : item.members) && (isStructMembers(item === null || item === void 0 ? void 0 : item.members) ? item.members.map(parseWithDetails) : item === null || item === void 0 ? void 0 : item.members);
+        return detailed;
+    }
+}
+exports.getDetailedLayout = getDetailedLayout;
+function isEnumMembers(members) {
+    return members.length === 0 || typeof members[0] === 'string';
+}
+exports.isEnumMembers = isEnumMembers;
+function isStructMembers(members) {
+    return members.length === 0 || typeof members[0] === 'object';
+}
+exports.isStructMembers = isStructMembers;
+//# sourceMappingURL=layout.js.map

package/dist/storage/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/storage/layout.ts"],"names":[],"mappings":";;;AAAA,0DAAmE;AA0CnE,SAAgB,iBAAiB,CAAC,MAAqB;IACrD,MAAM,KAAK,GAAuC,EAAE,CAAC;IAErD,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAE5C,SAAS,gBAAgB,CAA6B,IAAO;QAC3D,MAAM,MAAM,GAAG,2BAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACnD,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACxC,CAAC;IAED,SAAS,sBAAsB,CAAC,MAAoB;;QAClD,IAAI,MAAM,CAAC,EAAE,IAAI,KAAK,EAAE;YACtB,OAAO,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SACzB;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAuB;YACnC,GAAG,MAAM;YACT,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,SAAS;YACf,IAAI,EAAE;gBACJ,GAAG,IAAI;gBACP,OAAO,EAAE,SAAS;aACnB;SACF,CAAC;QAEF,wCAAwC;QACxC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC;QAE5B,QAAQ,CAAC,IAAI,GAAG,MAAA,MAAM,CAAC,IAAI,0CAAE,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACzD,QAAQ,CAAC,IAAI,GAAG,MAAA,MAAM,CAAC,IAAI,0CAAE,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACzD,QAAQ,CAAC,IAAI,CAAC,OAAO;YACnB,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,OAAO,KAAI,CAAC,eAAe,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,OAAO,CAAC,CAAC;QAEzG,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AArCD,8CAqCC;AAED,SAAgB,aAAa,CAAI,OAA2B;IAC1D,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;AAChE,CAAC;AAFD,sCAEC;AAED,SAAgB,eAAe,CAAI,OAA2B;IAC5D,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;AAChE,CAAC;AAFD,0CAEC"}

package/dist/storage/report.d.ts

@@ -0,0 +1,8 @@
+import type { StorageOperation, StorageItem } from './compare';
+export declare class LayoutCompatibilityReport {
+    readonly ops: StorageOperation<StorageItem>[];
+    readonly pass: boolean;
+    constructor(ops: StorageOperation<StorageItem>[]);
+    explain(): string;
+}
+//# sourceMappingURL=report.d.ts.map

package/dist/storage/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/storage/report.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAA2C,MAAM,WAAW,CAAC;AAKxG,qBAAa,yBAAyB;IAGxB,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,EAAE;IAFzD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAEF,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,EAAE;IAIzD,OAAO,IAAI,MAAM;CAYlB"}

package/dist/storage/report.js

@@ -0,0 +1,175 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LayoutCompatibilityReport = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const itemize_1 = require("../utils/itemize");
+const indent_1 = require("../utils/indent");
+const assert_1 = require("../utils/assert");
+class LayoutCompatibilityReport {
+    constructor(ops) {
+        this.ops = ops;
+        this.pass = ops.length === 0;
+    }
+    explain() {
+        const res = [];
+        for (const op of this.ops) {
+            const src = 'updated' in op ? op.updated.src : op.original.contract;
+            res.push(chalk_1.default.bold(src) + ':' + indent_1.indent(explainStorageOperation(op, { kind: 'layout', allowAppend: true }), 2, 1));
+        }
+        return res.join('\n\n');
+    }
+}
+exports.LayoutCompatibilityReport = LayoutCompatibilityReport;
+function explainStorageOperation(op, ctx) {
+    switch (op.kind) {
+        case 'typechange': {
+            const basic = explainTypeChange(op.change);
+            const details = ctx.kind === 'layout' // explain details for layout only
+                ? new Set(getAllTypeChanges(op.change)
+                    .map(explainTypeChangeDetails)
+                    .filter((d) => d !== undefined))
+                : [];
+            return `Upgraded ${label(op.updated)} to an incompatible type\n` + itemize_1.itemize(basic, ...details);
+        }
+        case 'rename':
+            return `Renamed ${label(op.original)} to ${label(op.updated)}`;
+        case 'replace':
+            return `Replaced ${label(op.original)} with ${label(op.updated)} of incompatible type`;
+        default: {
+            const title = explainBasicOperation(op, t => t.label);
+            const hints = [];
+            switch (op.kind) {
+                case 'insert': {
+                    if (ctx.kind === 'struct') {
+                        if (ctx.allowAppend) {
+                            hints.push('New struct members should be placed after existing ones');
+                        }
+                        else {
+                            hints.push('New struct members are not allowed here. Define a new struct');
+                        }
+                    }
+                    else {
+                        hints.push('New variables should be placed after all existing inherited variables');
+                    }
+                    break;
+                }
+                case 'delete': {
+                    hints.push('Keep the variable even if unused');
+                    break;
+                }
+            }
+            return title + '\n' + itemize_1.itemizeWith('>', ...hints);
+        }
+    }
+}
+function explainTypeChange(ch) {
+    switch (ch.kind) {
+        case 'obvious mismatch':
+        case 'struct members':
+        case 'enum members':
+            return `Bad upgrade ${describeTransition(ch.original, ch.updated)}`;
+        case 'enum resize':
+            return `Bad upgrade ${describeTransition(ch.original, ch.updated)}\nDifferent representation sizes`;
+        case 'mapping key':
+            return `In key of ${ch.updated.item.label}\n` + itemize_1.itemize(explainTypeChange(ch.inner));
+        case 'mapping value':
+        case 'array value':
+            return `In ${ch.updated.item.label}\n` + itemize_1.itemize(explainTypeChange(ch.inner));
+        case 'array shrink':
+        case 'array grow': {
+            assert_1.assert(ch.original.tail && ch.updated.tail);
+            const originalSize = parseInt(ch.original.tail, 10);
+            const updatedSize = parseInt(ch.updated.tail, 10);
+            const note = ch.kind === 'array shrink' ? 'Size cannot decrease' : 'Size cannot increase here';
+            return `Bad array resize from ${originalSize} to ${updatedSize}\n${note}`;
+        }
+        case 'array dynamic': {
+            assert_1.assert(ch.original.tail && ch.updated.tail);
+            const [originalSize, updatedSize] = ch.original.tail === 'dyn' ? ['dynamic', 'fixed'] : ['fixed', 'dynamic'];
+            return `Bad upgrade from ${originalSize} to ${updatedSize} size array`;
+        }
+        case 'missing members': {
+            const type = ch.updated.head.replace(/^t_/, ''); // t_struct, t_enum -> struct, enum
+            return `Insufficient data to compare ${type}s\nManually assess compatibility, then use option \`unsafeAllowCustomTypes: true\``;
+        }
+        case 'unknown':
+            return `Unknown type ${ch.updated.item.label}`;
+    }
+}
+function getAllTypeChanges(root) {
+    const list = [root];
+    for (const ch of list) {
+        switch (ch.kind) {
+            case 'mapping value':
+            case 'array value':
+                list.push(ch.inner);
+                break;
+            case 'struct members': {
+                for (const op of ch.ops) {
+                    if (op.kind === 'typechange') {
+                        list.push(op.change);
+                    }
+                }
+                break;
+            }
+            // We mention all other kinds explicitly to review any future new kinds
+            case 'obvious mismatch':
+            case 'enum members':
+            case 'enum resize':
+            case 'mapping key':
+            case 'array shrink':
+            case 'array grow':
+            case 'array dynamic':
+            case 'missing members':
+            case 'unknown':
+                break;
+        }
+    }
+    return list;
+}
+function explainTypeChangeDetails(ch) {
+    switch (ch.kind) {
+        case 'struct members': {
+            const { allowAppend } = ch;
+            return (`In ${ch.updated.item.label}\n` +
+                itemize_1.itemize(...ch.ops.map(op => explainStorageOperation(op, { kind: 'struct', allowAppend }))));
+        }
+        case 'enum members':
+            return `In ${ch.updated.item.label}\n` + itemize_1.itemize(...ch.ops.map(explainEnumOperation));
+    }
+}
+function explainEnumOperation(op) {
+    switch (op.kind) {
+        case 'replace':
+            return `Replaced \`${op.original}\` with \`${op.updated}\``;
+        default:
+            return explainBasicOperation(op, t => t);
+    }
+}
+function explainBasicOperation(op, getName) {
+    switch (op.kind) {
+        case 'delete':
+            return `Deleted \`${getName(op.original)}\``;
+        case 'insert':
+            return `Inserted \`${getName(op.updated)}\``;
+        case 'append':
+            return `Added \`${getName(op.updated)}\``;
+    }
+}
+function describeTransition(original, updated) {
+    const originalLabel = original.item.label;
+    const updatedLabel = updated.item.label;
+    if (originalLabel === updatedLabel) {
+        return `to ${updatedLabel}`;
+    }
+    else {
+        return `from ${originalLabel} to ${updatedLabel}`;
+    }
+}
+function label(variable) {
+    return '`' + variable.label + '`';
+}
+//# sourceMappingURL=report.js.map

package/dist/storage/report.js.map

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

package/dist/storage/report.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=report.test.d.ts.map

package/dist/storage/report.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.test.d.ts","sourceRoot":"","sources":["../../src/storage/report.test.ts"],"names":[],"mappings":""}

package/dist/storage/report.test.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ava_1 = __importDefault(require("ava"));
+const utils_1 = require("solidity-ast/utils");
+const hardhat_1 = require("hardhat");
+const ast_dereferencer_1 = require("../ast-dereferencer");
+const extract_1 = require("../storage/extract");
+const compare_1 = require("./compare");
+const layout_1 = require("./layout");
+const test = ava_1.default;
+const dummyDecodeSrc = () => 'file.sol:1';
+test.before(async (t) => {
+    const buildInfo = await hardhat_1.artifacts.getBuildInfo('contracts/test/Storage.sol:Storage1');
+    if (buildInfo === undefined) {
+        throw new Error('Build info not found');
+    }
+    const solcOutput = buildInfo.output;
+    const contracts = {};
+    for (const def of utils_1.findAll('ContractDefinition', solcOutput.sources['contracts/test/Storage.sol'].ast)) {
+        contracts[def.name] = def;
+    }
+    const deref = ast_dereferencer_1.astDereferencer(solcOutput);
+    t.context.extractStorageLayout = name => extract_1.extractStorageLayout(contracts[name], dummyDecodeSrc, deref);
+});
+function getReport(original, updated) {
+    const originalDetailed = layout_1.getDetailedLayout(original);
+    const updatedDetailed = layout_1.getDetailedLayout(updated);
+    const comparator = new compare_1.StorageLayoutComparator();
+    return comparator.compareLayouts(originalDetailed, updatedDetailed);
+}
+test('structs', t => {
+    const v1 = t.context.extractStorageLayout('StorageUpgrade_Struct_V1');
+    const v2 = t.context.extractStorageLayout('StorageUpgrade_Struct_V2_Bad');
+    const report = getReport(v1, v2);
+    t.snapshot(report.explain());
+});
+test('enums', t => {
+    const v1 = t.context.extractStorageLayout('StorageUpgrade_Enum_V1');
+    const v2 = t.context.extractStorageLayout('StorageUpgrade_Enum_V2_Bad');
+    const report = getReport(v1, v2);
+    t.snapshot(report.explain());
+});
+test('obvious mismatch', t => {
+    const v1 = t.context.extractStorageLayout('StorageUpgrade_ObviousMismatch_V1');
+    const v2 = t.context.extractStorageLayout('StorageUpgrade_ObviousMismatch_V2_Bad');
+    const report = getReport(v1, v2);
+    t.snapshot(report.explain());
+});
+test('array', t => {
+    const v1 = t.context.extractStorageLayout('StorageUpgrade_Array_V1');
+    const v2 = t.context.extractStorageLayout('StorageUpgrade_Array_V2_Bad');
+    const report = getReport(v1, v2);
+    t.snapshot(report.explain());
+});
+test('mapping', t => {
+    const v1 = t.context.extractStorageLayout('StorageUpgrade_Mapping_V1');
+    const v2 = t.context.extractStorageLayout('StorageUpgrade_Mapping_V2_Bad');
+    const report = getReport(v1, v2);
+    t.snapshot(report.explain());
+});
+test('mapping enum key', t => {
+    const v1 = t.context.extractStorageLayout('StorageUpgrade_MappingEnumKey_V1');
+    const v2 = t.context.extractStorageLayout('StorageUpgrade_MappingEnumKey_V2_Bad');
+    const report = getReport(v1, v2);
+    t.snapshot(report.explain());
+});
+test('rename', t => {
+    const v1 = t.context.extractStorageLayout('StorageUpgrade_Rename_V1');
+    const v2 = t.context.extractStorageLayout('StorageUpgrade_Rename_V2');
+    const report = getReport(v1, v2);
+    t.snapshot(report.explain());
+});
+test('replace', t => {
+    const v1 = t.context.extractStorageLayout('StorageUpgrade_Replace_V1');
+    const v2 = t.context.extractStorageLayout('StorageUpgrade_Replace_V2');
+    const report = getReport(v1, v2);
+    t.snapshot(report.explain());
+});
+//# sourceMappingURL=report.test.js.map