@decantr/essence-spec 1.0.7 → 2.0.0

package/dist/index.js

@@ -112,8 +112,11 @@ function getColumnPreset(col) {
   if (typeof col === "string") return void 0;
   return col.preset;
 }
-function isV3(essence) {
-  return (essence.version === "3.0.0" || essence.version === "3.1.0") && "dna" in essence && "blueprint" in essence;
+function isV4(essence) {
+  return typeof essence === "object" && essence !== null && essence.version === "4.0.0" && "dna" in essence && "blueprint" in essence;
+}
+function isLegacyV3(essence) {
+  return typeof essence === "object" && essence !== null && (essence.version === "3.0.0" || essence.version === "3.1.0") && "dna" in essence && "blueprint" in essence;
 }
 function flattenPages(blueprint) {
   if (blueprint.sections && blueprint.sections.length > 0) {
@@ -127,26 +130,19 @@ function flattenPages(blueprint) {
   return blueprint.pages ?? [];
 }
 function isSectioned(essence) {
-  if (isV3(essence)) return false;
-  return "sections" in essence && Array.isArray(essence.sections);
+  if (isV4(essence)) return false;
+  return typeof essence === "object" && essence !== null && "sections" in essence && Array.isArray(essence.sections);
 }
 function isSimple(essence) {
-  if (isV3(essence)) return false;
-  return "archetype" in essence && !("sections" in essence);
+  if (isV4(essence)) return false;
+  return typeof essence === "object" && essence !== null && "archetype" in essence && !("sections" in essence);
 }
 
 // src/guard.ts
 function checkThemeModeCompatibility(essence, context) {
   if (!context.themeRegistry) return null;
-  let themeId;
-  let mode;
-  if (isV3(essence)) {
-    themeId = essence.dna.theme?.id ?? null;
-    mode = essence.dna.theme?.mode ?? null;
-  } else {
-    themeId = isSimple(essence) ? essence.theme?.id : null;
-    mode = isSimple(essence) ? essence.theme?.mode : null;
-  }
+  const themeId = essence.dna.theme?.id ?? null;
+  const mode = essence.dna.theme?.mode ?? null;
   if (!themeId || !mode) return null;
   const theme = context.themeRegistry.get(themeId);
   if (!theme) {
@@ -160,7 +156,8 @@ function checkThemeModeCompatibility(essence, context) {
       severity: "error",
       message: `Theme "${themeId}" does not support "${mode}" mode. Supported modes: ${supportedModes}.`,
       suggestion,
-      ...isV3(essence) ? { layer: "dna", autoFixable: false } : {}
+      layer: "dna",
+      autoFixable: false
     };
   }
   return null;
@@ -213,17 +210,18 @@ function checkPatternExistence(essence, context) {
       const suggestion = similar.length > 0 ? `Similar patterns: ${similar.join(", ")}` : `Run "decantr search ${patternId}" to find alternatives.`;
       violations.push({
         rule: "pattern-exists",
-        severity: isV3(essence) ? "warning" : "error",
+        severity: "warning",
         message: `Pattern "${patternId}" is referenced but does not exist in the registry.`,
         suggestion,
-        ...isV3(essence) ? { layer: "blueprint", autoFixable: false } : {}
+        layer: "blueprint",
+        autoFixable: false
       });
     }
   }
   return violations;
 }
 function checkAccessibility(essence, context) {
-  const accessibility = isV3(essence) ? essence.dna.accessibility : "accessibility" in essence ? essence.accessibility : void 0;
+  const accessibility = essence.dna.accessibility;
   if (!accessibility?.wcag_level || accessibility.wcag_level === "none") {
     return null;
   }
@@ -235,7 +233,8 @@ function checkAccessibility(essence, context) {
       severity: "error",
       message: `WCAG ${accessibility.wcag_level} compliance required. Issues found: ${issueList}${moreCount}`,
       suggestion: "Fix accessibility issues before proceeding. Run an accessibility audit for details.",
-      ...isV3(essence) ? { layer: "dna", autoFixable: false } : {}
+      layer: "dna",
+      autoFixable: false
     };
   }
   return null;
@@ -244,8 +243,7 @@ function checkInteractions(essence, context) {
   if (!context.interaction_issues || context.interaction_issues.length === 0) {
     return null;
   }
-  const guard = isV3(essence) ? essence.meta.guard : null;
-  if (!guard) return null;
+  const guard = essence.meta.guard;
   let enforcement;
   if (guard.interactions_enforcement) {
     enforcement = guard.interactions_enforcement;
@@ -269,7 +267,7 @@ function checkInteractions(essence, context) {
   };
 }
 function evaluateGuard(essence, context = {}) {
-  const guard = isV3(essence) ? essence.meta.guard : essence.guard;
+  const guard = essence.meta.guard;
   if (guard.mode === "creative") {
     return [];
   }
@@ -277,19 +275,14 @@ function evaluateGuard(essence, context = {}) {
   const isStrict = guard.mode === "strict";
   const requestedTheme = context.theme ?? context.style;
   if (requestedTheme) {
-    let essenceThemeId;
-    if (isV3(essence)) {
-      essenceThemeId = essence.dna.theme.id;
-    } else {
-      essenceThemeId = isSimple(essence) ? essence.theme.id : null;
-    }
-    const enforceStyle = isV3(essence) ? true : guard.enforce_style !== false;
-    if (essenceThemeId && requestedTheme !== essenceThemeId && enforceStyle) {
+    const essenceThemeId = essence.dna.theme.id;
+    if (essenceThemeId && requestedTheme !== essenceThemeId) {
       violations.push({
         rule: "theme",
         severity: "error",
         message: `Theme "${requestedTheme}" does not match essence theme "${essenceThemeId}". Change the essence theme first.`,
-        ...isV3(essence) ? { layer: "dna", autoFixable: false } : {}
+        layer: "dna",
+        autoFixable: false
       });
     }
   }
@@ -299,13 +292,11 @@ function evaluateGuard(essence, context = {}) {
     if (!pageExists) {
       violations.push({
         rule: "structure",
-        severity: isV3(essence) ? "warning" : "error",
+        severity: "warning",
         message: `Page "${context.pageId}" does not exist in essence structure. Add it to the essence first.`,
-        ...isV3(essence) ? {
-          layer: "blueprint",
-          autoFixable: true,
-          autoFix: { type: "add_page", patch: { id: context.pageId } }
-        } : {}
+        layer: "blueprint",
+        autoFixable: true,
+        autoFix: { type: "add_page", patch: { id: context.pageId } }
       });
     }
   }
@@ -321,34 +312,28 @@ function evaluateGuard(essence, context = {}) {
       if (!matches) {
         violations.push({
           rule: "layout",
-          severity: isV3(essence) ? "warning" : "error",
+          severity: "warning",
           message: `Layout for page "${context.pageId}" deviates from essence. Expected: [${essenceLayout.join(", ")}].`,
-          ...isV3(essence) ? {
-            layer: "blueprint",
-            autoFixable: true,
-            autoFix: {
-              type: "update_layout",
-              patch: { page: context.pageId, layout: context.layout }
-            }
-          } : {}
+          layer: "blueprint",
+          autoFixable: true,
+          autoFix: {
+            type: "update_layout",
+            patch: { page: context.pageId, layout: context.layout }
+          }
         });
       }
     }
   }
   if (isStrict && context.density_gap) {
-    let expectedGap;
-    if (isV3(essence)) {
-      const overriddenDensity = getPageDensityOverride(essence, context.pageId);
-      expectedGap = overriddenDensity ?? essence.dna.spacing.content_gap;
-    } else {
-      expectedGap = essence.density.content_gap;
-    }
+    const overriddenDensity = getPageDensityOverride(essence, context.pageId);
+    const expectedGap = overriddenDensity ?? essence.dna.spacing.content_gap;
     if (context.density_gap !== expectedGap) {
       violations.push({
         rule: "density",
         severity: "warning",
         message: `Content gap "${context.density_gap}" does not match essence density "${expectedGap}".`,
-        ...isV3(essence) ? { layer: "dna", autoFixable: false } : {}
+        layer: "dna",
+        autoFixable: false
       });
     }
   }
@@ -366,37 +351,30 @@ function evaluateGuard(essence, context = {}) {
   if (interactionsViolation) {
     violations.push(interactionsViolation);
   }
-  if (isV3(essence)) {
-    const v3Guard = guard;
-    if (v3Guard.dna_enforcement === "off") {
-      return violations.filter((v) => v.layer !== "dna");
-    }
-    if (v3Guard.dna_enforcement === "warn") {
-      for (const v of violations) {
-        if (v.layer === "dna") {
-          v.severity = "warning";
-        }
+  const v4Guard = guard;
+  if (v4Guard.dna_enforcement === "off") {
+    return violations.filter((v) => v.layer !== "dna");
+  }
+  if (v4Guard.dna_enforcement === "warn") {
+    for (const v of violations) {
+      if (v.layer === "dna") {
+        v.severity = "warning";
       }
     }
-    if (v3Guard.blueprint_enforcement === "off") {
-      return violations.filter((v) => v.layer !== "blueprint");
-    }
+  }
+  if (v4Guard.blueprint_enforcement === "off") {
+    return violations.filter((v) => v.layer !== "blueprint");
   }
   return violations;
 }
 function getAllPages(essence) {
-  if (isV3(essence)) {
-    const pages = flattenPages(essence.blueprint);
-    return pages.map((page) => ({
-      id: page.id,
-      shell: page.shell_override ?? essence.blueprint.shell ?? "",
-      layout: page.layout,
-      ...page.surface ? { surface: page.surface } : {}
-    }));
-  }
-  if (isSimple(essence)) return essence.structure;
-  if (isSectioned(essence)) return essence.sections.flatMap((s) => s.structure);
-  throw new Error("Unknown EssenceFile type");
+  const pages = flattenPages(essence.blueprint);
+  return pages.map((page) => ({
+    id: page.id,
+    shell: page.shell_override ?? essence.blueprint.shell ?? "",
+    layout: page.layout,
+    ...page.surface ? { surface: page.surface } : {}
+  }));
 }
 function getPageDensityOverride(essence, pageId) {
   if (!pageId) return void 0;
@@ -412,72 +390,135 @@ function getPageDensityOverride(essence, pageId) {
 }
 
 // src/migrate.ts
-function migrateV2ToV3(essence) {
-  if (isV3(essence)) return essence;
-  if (isSectioned(essence)) {
-    return migrateSectionedToV3(essence);
-  }
-  if (isSimple(essence)) {
-    return migrateSimpleToV3(essence);
-  }
-  throw new Error("Unknown EssenceFile type \u2014 cannot migrate");
-}
-function migrateSimpleToV3(essence) {
+function migrateToV4(input) {
+  if (isV4(input)) return normalizeV4(input);
+  if (isLegacyV3(input)) return migrateLegacyV3ToV4(input);
+  if (isSectioned(input)) return migrateSectionedToV4(input);
+  if (isSimple(input)) return migrateSimpleToV4(input);
+  throw new Error("Unknown essence format. Only Essence v2, v3.0, v3.1, and v4 can migrate to v4.");
+}
+function migrateSimpleToV4(essence) {
   const dna = buildDNA(essence);
-  const blueprint = buildBlueprintFromSimple(essence);
-  const meta = buildMeta(essence);
+  const defaultShell = essence.structure[0]?.shell ?? "top-nav-main";
+  const pages = essence.structure.map((page, index) => ({
+    id: page.id,
+    route: page.id === "home" || index === 0 ? "/" : `/${page.id}`,
+    ...page.shell !== defaultShell ? { shell_override: page.shell } : {},
+    layout: page.layout,
+    ...page.surface ? { surface: page.surface } : {}
+  }));
+  const section = {
+    id: essence.archetype,
+    role: "primary",
+    shell: defaultShell,
+    features: essence.features ?? [],
+    description: `${essence.archetype} primary section`,
+    pages
+  };
   return {
-    version: "3.0.0",
+    version: "4.0.0",
     dna,
-    blueprint,
-    meta,
+    blueprint: buildSectionedBlueprint([section], essence.features ?? []),
+    meta: buildMeta(essence),
     ...essence._impression ? { _impression: essence._impression } : {}
   };
 }
-function migrateSectionedToV3(essence) {
+function migrateSectionedToV4(essence) {
   const firstSection = essence.sections[0];
+  if (!firstSection) {
+    throw new Error("Cannot migrate a sectioned essence with no sections.");
+  }
   const syntheticSimple = {
     theme: firstSection.theme,
     density: essence.density,
     guard: essence.guard,
-    accessibility: essence.accessibility
+    accessibility: essence.accessibility,
+    personality: essence.personality
   };
-  const dna = buildDNA(syntheticSimple);
-  dna.personality = essence.personality;
-  const pages = essence.sections.flatMap(
-    (section) => section.structure.map((page) => ({
-      id: page.id,
-      shell_override: page.shell,
-      layout: page.layout,
-      ...page.surface ? { surface: page.surface } : {}
-    }))
-  );
-  const allFeatures = [
+  const sections = essence.sections.map((section) => {
+    const defaultShell = section.structure[0]?.shell ?? "top-nav-main";
+    return {
+      id: section.id,
+      role: "primary",
+      shell: defaultShell,
+      features: section.features ?? [],
+      description: `${section.archetype} section`,
+      pages: section.structure.map((page, index) => ({
+        id: page.id,
+        route: index === 0 && section.path ? section.path : `${section.path}/${page.id}`.replace(/\/+/g, "/"),
+        ...page.shell !== defaultShell ? { shell_override: page.shell } : {},
+        layout: page.layout,
+        ...page.surface ? { surface: page.surface } : {}
+      }))
+    };
+  });
+  const features = [
     ...essence.shared_features ?? [],
-    ...essence.sections.flatMap((s) => s.features ?? [])
+    ...essence.sections.flatMap((section) => section.features ?? [])
   ];
-  const blueprint = {
-    shell: firstSection.structure[0]?.shell ?? "top-nav-main",
-    pages,
-    features: [...new Set(allFeatures)]
+  return {
+    version: "4.0.0",
+    dna: buildDNA(syntheticSimple),
+    blueprint: buildSectionedBlueprint(sections, [...new Set(features)]),
+    meta: {
+      archetype: firstSection.archetype,
+      target: essence.target,
+      platform: essence.platform,
+      guard: migrateGuard(essence.guard.mode)
+    },
+    ...essence._impression ? { _impression: essence._impression } : {}
   };
-  const meta = {
-    archetype: firstSection.archetype,
-    target: essence.target,
-    platform: essence.platform,
-    guard: migrateGuard(essence.guard.mode)
+}
+function migrateLegacyV3ToV4(essence) {
+  const sections = essence.blueprint.sections && essence.blueprint.sections.length > 0 ? essence.blueprint.sections : [
+    {
+      id: essence.meta.archetype,
+      role: "primary",
+      shell: essence.blueprint.shell ?? "top-nav-main",
+      features: essence.blueprint.features,
+      description: `${essence.meta.archetype} primary section`,
+      pages: essence.blueprint.pages ?? []
+    }
+  ];
+  return normalizeV4({
+    ...essence,
+    version: "4.0.0",
+    blueprint: buildSectionedBlueprint(
+      sections,
+      essence.blueprint.features,
+      essence.blueprint.routes
+    )
+  });
+}
+function normalizeV4(essence) {
+  return {
+    ...essence,
+    version: "4.0.0",
+    blueprint: buildSectionedBlueprint(
+      essence.blueprint.sections,
+      essence.blueprint.features,
+      essence.blueprint.routes,
+      essence.blueprint.shell
+    )
   };
+}
+function buildSectionedBlueprint(sections, features, existingRoutes, shell) {
+  const routes = { ...existingRoutes ?? {} };
+  for (const section of sections) {
+    for (const page of section.pages) {
+      if (!page.route || routes[page.route]) continue;
+      routes[page.route] = { section: section.id, page: page.id };
+    }
+  }
   return {
-    version: "3.0.0",
-    dna,
-    blueprint,
-    meta,
-    ...essence._impression ? { _impression: essence._impression } : {}
+    ...shell ? { shell } : {},
+    sections,
+    features: [...new Set(features)],
+    routes
   };
 }
 function buildDNA(essence) {
   const shape = essence.theme.shape ?? "rounded";
-  const radiusBase = inferRadiusBase(shape);
   return {
     theme: {
       id: essence.theme.id,
@@ -488,7 +529,7 @@ function buildDNA(essence) {
       base_unit: 4,
       scale: "linear",
       density: essence.density?.level ?? "comfortable",
-      content_gap: essence.density?.content_gap ?? "4"
+      content_gap: essence.density?.content_gap ?? "_gap4"
     },
     typography: {
       scale: "modular",
@@ -502,7 +543,7 @@ function buildDNA(essence) {
     },
     radius: {
       philosophy: shape,
-      base: radiusBase
+      base: inferRadiusBase(shape)
     },
     elevation: {
       system: "layered",
@@ -521,19 +562,6 @@ function buildDNA(essence) {
     personality: essence.personality ?? ["professional"]
   };
 }
-function buildBlueprintFromSimple(essence) {
-  const defaultShell = essence.structure[0]?.shell ?? "top-nav-main";
-  return {
-    shell: defaultShell,
-    pages: essence.structure.map((page) => ({
-      id: page.id,
-      ...page.shell !== defaultShell ? { shell_override: page.shell } : {},
-      layout: page.layout,
-      ...page.surface ? { surface: page.surface } : {}
-    })),
-    features: essence.features ?? []
-  };
-}
 function buildMeta(essence) {
   return {
     archetype: essence.archetype,
@@ -565,135 +593,14 @@ function inferRadiusBase(shape) {
       return 8;
   }
 }
-function migrateV30ToV31(essence) {
-  if (essence.version === "3.1.0" || essence.blueprint.sections) {
-    return essence;
-  }
-  const section = {
-    id: essence.meta.archetype,
-    role: "primary",
-    shell: essence.blueprint.shell ?? "top-nav-main",
-    features: essence.blueprint.features,
-    description: `${essence.meta.archetype} primary section`,
-    pages: essence.blueprint.pages ?? []
-  };
-  return {
-    ...essence,
-    version: "3.1.0",
-    blueprint: {
-      ...essence.blueprint,
-      sections: [section],
-      pages: void 0,
-      routes: {}
-    }
-  };
-}
 
 // src/normalize.ts
+var V4_REQUIRED_MESSAGE = "Active Decantr V2 workflows require Essence v4.0.0. Run `decantr migrate --to v4` for older essence files.";
 function normalizeEssence(input) {
-  if (input.version === "3.0.0" || input.version === "3.1.0") {
-    return input;
-  }
-  if (input.theme && input.platform) {
+  if (isV4(input)) {
     return input;
   }
-  if (input.sections) {
-    return normalizeSectioned(input);
-  }
-  return normalizeSimple(input);
-}
-function normalizeSimple(v1) {
-  const vintage = v1.vintage;
-  const vessel = v1.vessel;
-  const clarity = v1.clarity;
-  const cork = v1.cork;
-  const structure = v1.structure;
-  return {
-    version: "2.0.0",
-    archetype: v1.terroir ?? v1.vignette ?? v1.archetype,
-    theme: {
-      id: vintage?.style ?? "",
-      mode: vintage?.mode ?? "dark",
-      ...vintage?.shape ? { shape: vintage.shape } : {}
-    },
-    // Accept both old 'character' and new 'personality' field names
-    personality: v1.character ?? v1.personality,
-    platform: {
-      type: vessel?.type ?? "spa",
-      // Modern-SPA default. See packages/cli/src/scaffold.ts getPlatformMeta for rationale.
-      routing: vessel?.routing ?? "history"
-    },
-    structure: (structure ?? []).map(normalizeStructurePage),
-    features: v1.tannins ?? v1.features ?? [],
-    density: {
-      level: clarity?.density ?? "comfortable",
-      content_gap: stripGapPrefix(clarity?.content_gap ?? "4")
-    },
-    guard: normalizeGuard(cork),
-    target: v1.target ?? "decantr",
-    ...v1._impression ? { _impression: v1._impression } : {}
-  };
-}
-function normalizeSectioned(v1) {
-  const vessel = v1.vessel;
-  const clarity = v1.clarity;
-  const cork = v1.cork;
-  const sections = v1.sections;
-  return {
-    version: "2.0.0",
-    platform: {
-      type: vessel?.type ?? "spa",
-      // Modern-SPA default. See packages/cli/src/scaffold.ts getPlatformMeta for rationale.
-      routing: vessel?.routing ?? "history"
-    },
-    // Accept both old 'character' and new 'personality' field names
-    personality: v1.character ?? v1.personality,
-    sections: sections.map((section) => ({
-      id: section.id,
-      path: section.path,
-      archetype: section.terroir ?? section.vignette ?? section.archetype,
-      theme: {
-        id: section.vintage?.style ?? "",
-        mode: section.vintage?.mode ?? "dark"
-      },
-      structure: (section.structure ?? []).map(
-        normalizeStructurePage
-      ),
-      ...section.tannins ? { features: section.tannins } : {}
-    })),
-    ...v1.shared_tannins ? { shared_features: v1.shared_tannins } : {},
-    density: {
-      level: clarity?.density ?? "comfortable",
-      content_gap: stripGapPrefix(clarity?.content_gap ?? "4")
-    },
-    guard: normalizeGuard(cork),
-    target: v1.target ?? "decantr"
-  };
-}
-function normalizeStructurePage(page) {
-  return {
-    id: page.id,
-    shell: page.carafe ?? page.shell,
-    layout: page.blend ?? page.layout,
-    ...page.surface ? { surface: page.surface } : {}
-  };
-}
-function normalizeGuard(cork) {
-  if (!cork) return { mode: "creative" };
-  const modeMap = {
-    creative: "creative",
-    maintenance: "strict",
-    strict: "strict",
-    guided: "guided"
-  };
-  return {
-    ...cork.enforce_style !== void 0 ? { enforce_style: cork.enforce_style } : {},
-    mode: modeMap[cork.mode ?? "creative"] ?? "creative"
-  };
-}
-function stripGapPrefix(gap) {
-  const match = gap.match(/^_gap(\d+)$/);
-  return match ? match[1] : gap;
+  throw new Error(V4_REQUIRED_MESSAGE);
 }
 
 // src/validate.ts
@@ -704,6 +611,7 @@ import Ajv from "ajv";
 var __dirname = dirname(fileURLToPath(import.meta.url));
 var v2SchemaPath = join(__dirname, "..", "schema", "essence.v2.json");
 var v3SchemaPath = join(__dirname, "..", "schema", "essence.v3.json");
+var v4SchemaPath = join(__dirname, "..", "schema", "essence.v4.json");
 var cachedAjv = null;
 var validatorCache = /* @__PURE__ */ new Map();
 function getAjv() {
@@ -714,7 +622,7 @@ function getAjv() {
 }
 function getValidator(version) {
   if (validatorCache.has(version)) return validatorCache.get(version);
-  const schemaPath = version === "v3" ? v3SchemaPath : v2SchemaPath;
+  const schemaPath = version === "v4" ? v4SchemaPath : version === "v3" ? v3SchemaPath : v2SchemaPath;
   if (!existsSync(schemaPath)) return null;
   const schema = JSON.parse(readFileSync(schemaPath, "utf-8"));
   const ajv = getAjv();
@@ -722,7 +630,7 @@ function getValidator(version) {
   validatorCache.set(version, validate);
   return validate;
 }
-function detectVersion(data) {
+function detectLegacyVersion(data) {
   if (typeof data === "object" && data !== null && "version" in data) {
     const v = data.version;
     if (v === "3.0.0" || v === "3.1.0") return "v3";
@@ -730,7 +638,32 @@ function detectVersion(data) {
   return "v2";
 }
 function validateEssence(data) {
-  const version = detectVersion(data);
+  const version = typeof data === "object" && data !== null ? data.version : void 0;
+  if (version !== "4.0.0") {
+    return {
+      valid: false,
+      errors: [
+        "Active Decantr V2 workflows require Essence v4.0.0. Run `decantr migrate --to v4` for older essence files."
+      ]
+    };
+  }
+  const validate = getValidator("v4");
+  if (!validate) {
+    return { valid: false, errors: ["No schema available for v4 documents"] };
+  }
+  const valid = validate(data);
+  if (valid) {
+    return { valid: true, errors: [] };
+  }
+  const errors = (validate.errors ?? []).map((err) => {
+    const path = err.instancePath || "/";
+    const msg = err.message ?? "unknown error";
+    return `${path}: ${msg}`;
+  });
+  return { valid: false, errors };
+}
+function validateLegacyEssenceForMigration(data) {
+  const version = typeof data === "object" && data !== null && data.version === "4.0.0" ? "v4" : detectLegacyVersion(data);
   const validate = getValidator(version);
   if (!validate) {
     return { valid: false, errors: [`No schema available for ${version} documents`] };
@@ -754,12 +687,13 @@ export {
   getColumnAlias,
   getColumnId,
   getColumnPreset,
+  isLegacyV3,
   isSectioned,
   isSimple,
-  isV3,
-  migrateV2ToV3,
-  migrateV30ToV31,
+  isV4,
+  migrateToV4,
   normalizeEssence,
-  validateEssence
+  validateEssence,
+  validateLegacyEssenceForMigration
 };
 //# sourceMappingURL=index.js.map