Merge pull request #240 from IntersectMBO/worktree-shiny-giggling-frost

refactor: flatten module structure to eliminate webpack casing conflicts

Author: solidsnakedev

.changeset/flat-module-structure.md

@@ -0,0 +1,12 @@
+---
+"@evolution-sdk/evolution": minor
+---
+
+Flatten module structure to eliminate webpack casing conflicts on case-insensitive filesystems. The wildcard export now maps PascalCase filenames directly — namespace name equals filename equals import path, removing the directory/namespace casing mismatch that caused dual module identifiers in webpack builds.
+
+Modules previously nested in concept folders (address/, block/, transaction/, etc.) are now flat PascalCase files at the package root. Three subdirectories remain for separate domains with naming collisions: `plutus/` (on-chain script types), `cose/` (message signing protocol), and `blueprint/` (CIP-57 codegen). Deep imports into subdirectories are blocked.
+
+- Concept-folder subpath imports like `@evolution-sdk/evolution/address` are removed. Use the root barrel (`import { Address } from "@evolution-sdk/evolution"`) or the wildcard (`import * as Address from "@evolution-sdk/evolution/Address"`).
+- `MessageSigning` is renamed to `COSE` in the root barrel export.
+- `./plutus`, `./cose`, and `./blueprint` are available as subpath imports with namespaced barrels.
+- Blueprint barrel now uses `export * as` instead of `export *`.

docs/app/tools/blueprint-codegen/blueprint-codegen.tsx

@@ -4,7 +4,9 @@ import { useState } from "react"
 import { Blueprint } from "@evolution-sdk/evolution"
 import { DynamicCodeBlock } from "fumadocs-ui/components/dynamic-codeblock"
 
-const { PlutusBlueprint, generateTypeScript, createCodegenConfig } = Blueprint
+const { PlutusBlueprint } = Blueprint.Types
+const { generateTypeScript } = Blueprint.Codegen
+const { createCodegenConfig } = Blueprint.CodegenConfig
 
 export function BlueprintCodegen() {
   const [blueprintJson, setBlueprintJson] = useState("")

docs/content/docs/addresses/index.mdx

@@ -40,8 +40,8 @@ const address = new Address.Address({
 ### Option 2: Direct Module Imports
 
 ```typescript twoslash
-import { Address } from "@evolution-sdk/evolution/address/Address";
-import { KeyHash } from "@evolution-sdk/evolution/credential/KeyHash";
+import { Address } from "@evolution-sdk/evolution/Address";
+import { KeyHash } from "@evolution-sdk/evolution/KeyHash";
 
 // Same functionality, imported directly from modules
 const paymentCred = new KeyHash({ hash: new Uint8Array(28) });

docs/content/docs/encoding/cbor.mdx

@@ -23,7 +23,7 @@ Most application code should use the module-specific APIs (`Transaction.fromCBOR
 ## Quick Start
 
 ```typescript twoslash
-import { CBOR } from "@evolution-sdk/evolution/encoding"
+import { CBOR } from "@evolution-sdk/evolution"
 
 // Decode hex to a typed CBOR value
 const value = CBOR.fromCBORHex("83010203")
@@ -48,7 +48,7 @@ const bytes = CBOR.toCBORBytes(value)
 `CBOR.fromCBORHex` returns a `CBOR` value — a discriminated union over every CBOR major type:
 
 ```typescript twoslash
-import { CBOR } from "@evolution-sdk/evolution/encoding"
+import { CBOR } from "@evolution-sdk/evolution"
 
 // bigint      ← CBOR major 0 (uint) and major 1 (nint)
 const uint: CBOR.CBOR = 42n
@@ -69,7 +69,7 @@ const text: CBOR.CBOR = "hello"
 Use the type guards to narrow before accessing:
 
 ```typescript twoslash
-import { CBOR } from "@evolution-sdk/evolution/encoding"
+import { CBOR } from "@evolution-sdk/evolution"
 
 const raw = CBOR.fromCBORHex("a2016161026162") // { 1 → "a", 2 → "b" }
 
@@ -88,7 +88,7 @@ Standard CBOR decode throws away encoding choices: whether an integer used 1 or
 `CBORFormat` is a discriminated union (8 variants) that captures the complete encoding tree for every CBOR node. `fromCBORHexWithFormat` / `fromCBORBytesWithFormat` decode and capture it simultaneously. `toCBORHexWithFormat` / `toCBORBytesWithFormat` replay the captured tree exactly.
 
 ```typescript twoslash
-import { CBOR } from "@evolution-sdk/evolution/encoding"
+import { CBOR } from "@evolution-sdk/evolution"
 
 // "1800" = integer 0 encoded as a 1-byte uint (non-canonical; minimal is "00")
 const hex = "1800"
@@ -128,7 +128,7 @@ The plain `toCBORHex`/`toCBORBytes` APIs accept a `CodecOptions` argument that c
 | `CARDANO_NODE_DATA_OPTIONS` | Definite Plutus data (tooling compatibility) |
 
 ```typescript twoslash
-import { CBOR } from "@evolution-sdk/evolution/encoding"
+import { CBOR } from "@evolution-sdk/evolution"
 
 const value = CBOR.fromCBORHex("a2026161016162") // map with non-sorted keys
 
@@ -162,7 +162,7 @@ const canonicalHex = CBOR.toCBORHex(value, CBOR.CANONICAL_OPTIONS)
 ### Type Guards
 
 ```typescript twoslash
-import { CBOR } from "@evolution-sdk/evolution/encoding"
+import { CBOR } from "@evolution-sdk/evolution"
 
 const v: CBOR.CBOR = CBOR.fromCBORHex("01")
 
@@ -179,7 +179,7 @@ CBOR.isTag(v)       // v is { _tag: "Tag"; tag: number; value: CBOR.CBOR }
 `match` provides exhaustive pattern matching over a `CBOR` value, analogous to a switch on the full union:
 
 ```typescript twoslash
-import { CBOR } from "@evolution-sdk/evolution/encoding"
+import { CBOR } from "@evolution-sdk/evolution"
 
 const value = CBOR.fromCBORHex("43010203") // bytes [01, 02, 03]
 
@@ -207,7 +207,7 @@ const result = CBOR.match(value, {
 If your code receives a `Transaction` CBOR hex from a client, adds witnesses, and returns the result, use `WithFormat` at the transaction level to guarantee the body bytes — and thus the `txId` — are never altered:
 
 ```typescript twoslash
-import { Transaction } from "@evolution-sdk/evolution/transaction"
+import { Transaction } from "@evolution-sdk/evolution"
 
 function addWalletWitnesses(txHex: string, walletWitnessHex: string): string {
   // Byte-level splice: body bytes untouched, txId stable
@@ -218,7 +218,7 @@ function addWalletWitnesses(txHex: string, walletWitnessHex: string): string {
 For cases where you need to inspect the transaction before re-encoding, use the WithFormat round-trip:
 
 ```typescript twoslash
-import { Transaction } from "@evolution-sdk/evolution/transaction"
+import { Transaction } from "@evolution-sdk/evolution"
 
 function inspectAndReserialize(txHex: string): string {
   const { format, value: tx } = Transaction.fromCBORHexWithFormat(txHex)
@@ -236,7 +236,7 @@ function inspectAndReserialize(txHex: string): string {
 When you need a specific encoding shape that differs from the defaults — e.g. forcing an indefinite-length array — build the `CBORFormat` explicitly:
 
 ```typescript twoslash
-import { CBOR } from "@evolution-sdk/evolution/encoding"
+import { CBOR } from "@evolution-sdk/evolution"
 
 const fmt: CBOR.CBORFormat = {
   _tag: "array",
@@ -253,7 +253,7 @@ const hex = CBOR.toCBORHexWithFormat([1n, 2n], fmt)
 `fromCBORHex` returns `CBOR`, not a narrowed type. Always check before indexing:
 
 ```typescript twoslash
-import { CBOR } from "@evolution-sdk/evolution/encoding"
+import { CBOR } from "@evolution-sdk/evolution"
 
 function getMapEntry(hex: string, key: bigint): CBOR.CBOR | undefined {
   const v = CBOR.fromCBORHex(hex)

docs/content/docs/encoding/plutus.mdx

@@ -171,7 +171,7 @@ Multi-asset value representing ADA and native tokens as nested maps.
 ```typescript twoslash
 import { Value } from "@evolution-sdk/evolution/plutus"
 import { Bytes, Data } from "@evolution-sdk/evolution"
-import { Text } from "@evolution-sdk/evolution/primitives"
+import { Text } from "@evolution-sdk/evolution"
 
 // ADA only
 const adaOnly: Value.Value = new Map([
@@ -232,7 +232,7 @@ Reference token metadata following CIP-68 standard with versioning and extensibi
 ```typescript twoslash
 import { CIP68Metadata } from "@evolution-sdk/evolution/plutus"
 import { Bytes, Data } from "@evolution-sdk/evolution"
-import { Text } from "@evolution-sdk/evolution/primitives"
+import { Text } from "@evolution-sdk/evolution"
 
 // NFT metadata (label 222)
 const nftMetadata = Data.map([
@@ -352,7 +352,7 @@ Complete CIP-68 NFT mint creating both reference token (label 100, immutable met
 ```typescript twoslash
 import { CIP68Metadata, Value } from "@evolution-sdk/evolution/plutus"
 import { Bytes, Data } from "@evolution-sdk/evolution"
-import { Text } from "@evolution-sdk/evolution/primitives"
+import { Text } from "@evolution-sdk/evolution"
 
 // Metadata for both reference and user tokens
 const metadata = Data.map([
@@ -394,7 +394,7 @@ Decentralized exchange limit order specifying what assets are offered, what's re
 ```typescript twoslash
 import { Credential, Value } from "@evolution-sdk/evolution/plutus"
 import { Bytes, Data } from "@evolution-sdk/evolution"
-import { Text } from "@evolution-sdk/evolution/primitives"
+import { Text } from "@evolution-sdk/evolution"
 
 interface DexOrderDatum {
   owner: Credential.Credential

packages/aiken-uplc/src/Evaluator.ts

@@ -4,18 +4,18 @@
  * @packageDocumentation
  */
 
-import * as Bytes from "@evolution-sdk/evolution/bytes/Bytes"
-import * as CBOR from "@evolution-sdk/evolution/encoding/CBOR"
-import * as CostModel from "@evolution-sdk/evolution/script/CostModel"
-import * as Redeemer from "@evolution-sdk/evolution/script/Redeemer"
-import * as Script from "@evolution-sdk/evolution/script/Script"
-import * as ScriptRef from "@evolution-sdk/evolution/script/ScriptRef"
+import * as Bytes from "@evolution-sdk/evolution/Bytes"
+import * as CBOR from "@evolution-sdk/evolution/CBOR"
+import * as CostModel from "@evolution-sdk/evolution/CostModel"
+import * as Redeemer from "@evolution-sdk/evolution/Redeemer"
+import * as Script from "@evolution-sdk/evolution/Script"
+import * as ScriptRef from "@evolution-sdk/evolution/ScriptRef"
 import * as TransactionBuilder from "@evolution-sdk/evolution/sdk/builders/TransactionBuilder"
 import type * as EvalRedeemer from "@evolution-sdk/evolution/sdk/EvalRedeemer"
-import * as Transaction from "@evolution-sdk/evolution/transaction/Transaction"
-import * as TransactionInput from "@evolution-sdk/evolution/transaction/TransactionInput"
-import * as TxOut from "@evolution-sdk/evolution/transaction/TxOut"
-import type * as UTxO from "@evolution-sdk/evolution/transaction/UTxO"
+import * as Transaction from "@evolution-sdk/evolution/Transaction"
+import * as TransactionInput from "@evolution-sdk/evolution/TransactionInput"
+import * as TxOut from "@evolution-sdk/evolution/TxOut"
+import type * as UTxO from "@evolution-sdk/evolution/UTxO"
 import { Effect } from "effect"
 
 /**

packages/evolution-devnet/src/Genesis.ts

@@ -1,8 +1,8 @@
-import * as Address from "@evolution-sdk/evolution/address/Address"
-import * as AddressEras from "@evolution-sdk/evolution/address/AddressEras"
-import * as Assets from "@evolution-sdk/evolution/assets"
-import * as TransactionHash from "@evolution-sdk/evolution/transaction/TransactionHash"
-import * as UTxO from "@evolution-sdk/evolution/transaction/UTxO"
+import * as Address from "@evolution-sdk/evolution/Address"
+import * as AddressEras from "@evolution-sdk/evolution/AddressEras"
+import * as Assets from "@evolution-sdk/evolution/Assets"
+import * as TransactionHash from "@evolution-sdk/evolution/TransactionHash"
+import * as UTxO from "@evolution-sdk/evolution/UTxO"
 import { blake2b } from "@noble/hashes/blake2"
 import { Data, Effect } from "effect"
 

packages/evolution-devnet/test/Client.Devnet.test.ts

@@ -3,7 +3,7 @@ import * as Cluster from "@evolution-sdk/devnet/Cluster"
 import * as Config from "@evolution-sdk/devnet/Config"
 import * as Genesis from "@evolution-sdk/devnet/Genesis"
 import { Cardano, Client, preprod } from "@evolution-sdk/evolution"
-import * as CoreAddress from "@evolution-sdk/evolution/address/Address"
+import * as CoreAddress from "@evolution-sdk/evolution/Address"
 import { afterAll, beforeAll } from "vitest"
 
 // Alias for Cardano.Assets

packages/evolution-devnet/test/Devnet.Genesis.test.ts

@@ -3,7 +3,7 @@ import * as Cluster from "@evolution-sdk/devnet/Cluster"
 import * as Config from "@evolution-sdk/devnet/Config"
 import * as Genesis from "@evolution-sdk/devnet/Genesis"
 import { Cardano } from "@evolution-sdk/evolution"
-import * as CoreAddress from "@evolution-sdk/evolution/address/Address"
+import * as CoreAddress from "@evolution-sdk/evolution/Address"
 import { afterAll, beforeAll } from "vitest"
 
 /**

packages/evolution-devnet/test/Devnet.integration.test.ts

@@ -1,11 +1,11 @@
 import { afterAll, describe, expect, it } from "@effect/vitest"
 import * as Cluster from "@evolution-sdk/devnet/Cluster"
 import * as Container from "@evolution-sdk/devnet/Container"
-import * as AddressEras from "@evolution-sdk/evolution/address/AddressEras"
-import * as EnterpriseAddress from "@evolution-sdk/evolution/address/EnterpriseAddress"
-import * as KeyHash from "@evolution-sdk/evolution/credential/KeyHash"
-import * as PrivateKey from "@evolution-sdk/evolution/credential/PrivateKey"
-import * as VKey from "@evolution-sdk/evolution/credential/VKey"
+import * as AddressEras from "@evolution-sdk/evolution/AddressEras"
+import * as EnterpriseAddress from "@evolution-sdk/evolution/EnterpriseAddress"
+import * as KeyHash from "@evolution-sdk/evolution/KeyHash"
+import * as PrivateKey from "@evolution-sdk/evolution/PrivateKey"
+import * as VKey from "@evolution-sdk/evolution/VKey"
 import Docker from "dockerode"
 import { Effect } from "effect"